@mohasinac/appkit 2.3.0 → 2.3.2

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

@@ -0,0 +1,125 @@
+/**
+ * Products Firestore Document Types & Constants
+ */
+import { type GenerateProductIdInput, type GenerateAuctionIdInput, type GeneratePreOrderIdInput } from "../../../utils/id-generators";
+import type { ProductStatus } from "../types";
+export interface ProductVideoField {
+    url: string;
+    thumbnailUrl: string;
+    duration: number;
+    trimStart?: number;
+    trimEnd?: number;
+}
+export interface ProductSpecification {
+    name: string;
+    value: string;
+    unit?: string;
+}
+export interface ProductDocument {
+    id: string;
+    title: string;
+    description: string;
+    slug?: string;
+    seoTitle?: string;
+    seoDescription?: string;
+    seoKeywords?: string[];
+    category: string;
+    subcategory?: string;
+    brand?: string;
+    price: number;
+    currency: string;
+    stockQuantity: number;
+    availableQuantity: number;
+    mainImage: string;
+    images: string[];
+    video?: ProductVideoField;
+    status: ProductStatus;
+    sellerId: string;
+    storeId?: string;
+    sellerName: string;
+    sellerEmail: string;
+    featured: boolean;
+    tags: string[];
+    specifications?: ProductSpecification[];
+    features?: string[];
+    shippingInfo?: string;
+    returnPolicy?: string;
+    condition?: "new" | "used" | "refurbished" | "broken";
+    insurance?: boolean;
+    insuranceCost?: number;
+    shippingPaidBy?: "seller" | "buyer";
+    isAuction?: boolean;
+    auctionEndDate?: Date;
+    startingBid?: number;
+    currentBid?: number;
+    bidCount?: number;
+    reservePrice?: number;
+    buyNowPrice?: number;
+    minBidIncrement?: number;
+    autoExtendable?: boolean;
+    auctionExtensionMinutes?: number;
+    auctionOriginalEndDate?: Date;
+    auctionShippingPaidBy?: "seller" | "winner";
+    isPreOrder?: boolean;
+    preOrderDeliveryDate?: Date;
+    preOrderDepositPercent?: number;
+    preOrderDepositAmount?: number;
+    preOrderMaxQuantity?: number;
+    preOrderCurrentCount?: number;
+    preOrderProductionStatus?: "upcoming" | "in_production" | "ready_to_ship";
+    preOrderCancellable?: boolean;
+    isPromoted?: boolean;
+    promotionEndDate?: Date;
+    pickupAddressId?: string;
+    viewCount?: number;
+    avgRating?: number;
+    reviewCount?: number;
+    bulkDiscounts?: {
+        quantity: number;
+        discountPercent: number;
+    }[];
+    ingredients?: string[];
+    howToUse?: string[];
+    allowOffers?: boolean;
+    minOfferPercent?: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** Runtime-accessible product status values — use instead of bare string literals. */
+export declare const ProductStatusValues: {
+    readonly DRAFT: "draft";
+    readonly PUBLISHED: "published";
+    readonly ARCHIVED: "archived";
+    readonly SOLD: "sold";
+    readonly OUT_OF_STOCK: "out_of_stock";
+    readonly DISCONTINUED: "discontinued";
+};
+export declare const PRODUCT_COLLECTION: "products";
+export declare const PRODUCT_INDEXED_FIELDS: readonly ["sellerId", "status", "category", "featured", "isAuction", "isPreOrder", "isPromoted", "createdAt"];
+export declare const DEFAULT_PRODUCT_DATA: Partial<ProductDocument>;
+export declare const PRODUCT_PUBLIC_FIELDS: readonly ["id", "title", "description", "category", "subcategory", "brand", "price", "currency", "stockQuantity", "availableQuantity", "images", "status", "sellerName", "featured", "tags", "specifications", "features", "shippingInfo", "returnPolicy", "isAuction", "auctionEndDate", "startingBid", "currentBid", "bidCount", "reservePrice", "buyNowPrice", "minBidIncrement", "autoExtendable", "auctionExtensionMinutes", "auctionShippingPaidBy", "isPreOrder", "preOrderDeliveryDate", "preOrderDepositPercent", "preOrderDepositAmount", "preOrderMaxQuantity", "preOrderCurrentCount", "preOrderProductionStatus", "preOrderCancellable", "condition", "insurance", "insuranceCost", "shippingPaidBy", "isPromoted", "slug", "seoTitle", "seoDescription", "seoKeywords", "viewCount", "createdAt"];
+export declare const PRODUCT_UPDATABLE_FIELDS: readonly ["title", "description", "category", "subcategory", "brand", "price", "stockQuantity", "images", "status", "tags", "specifications", "features", "shippingInfo", "returnPolicy", "pickupAddressId", "condition", "insurance", "shippingPaidBy", "autoExtendable", "auctionExtensionMinutes", "auctionShippingPaidBy", "reservePrice", "buyNowPrice", "minBidIncrement", "isPreOrder", "preOrderDeliveryDate", "preOrderDepositPercent", "preOrderDepositAmount", "preOrderMaxQuantity", "preOrderProductionStatus", "preOrderCancellable", "seoTitle", "seoDescription", "seoKeywords"];
+export type ProductCreateInput = Omit<ProductDocument, "id" | "createdAt" | "updatedAt" | "availableQuantity" | "bidCount" | "currentBid" | "auctionOriginalEndDate">;
+export type ProductUpdateInput = Partial<Pick<ProductDocument, (typeof PRODUCT_UPDATABLE_FIELDS)[number]>>;
+export type ProductAdminUpdateInput = Partial<Omit<ProductDocument, "id" | "createdAt">>;
+export declare const productQueryHelpers: {
+    readonly bySeller: (sellerId: string) => readonly ["sellerId", "==", string];
+    readonly byStatus: (status: ProductStatus) => readonly ["status", "==", ProductStatus];
+    readonly byCategory: (category: string) => readonly ["category", "==", string];
+    readonly featured: () => readonly ["featured", "==", true];
+    readonly published: () => readonly ["status", "==", "published"];
+    readonly available: () => readonly ["availableQuantity", ">", 0];
+    readonly auctions: () => readonly ["isAuction", "==", true];
+    readonly preOrders: () => readonly ["isPreOrder", "==", true];
+    readonly promoted: () => readonly ["isPromoted", "==", true];
+    readonly activeAuction: (date: Date) => readonly ["auctionEndDate", ">=", Date];
+};
+export declare function createProductId(input: Omit<GenerateProductIdInput, "count"> & {
+    count?: number;
+}): string;
+export declare function createAuctionId(input: Omit<GenerateAuctionIdInput, "count"> & {
+    count?: number;
+}): string;
+export declare function createPreOrderId(input: Omit<GeneratePreOrderIdInput, "count"> & {
+    count?: number;
+}): string;

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

@@ -0,0 +1,149 @@
+/**
+ * Products Firestore Document Types & Constants
+ */
+import { generateProductId, generateAuctionId, generatePreOrderId, } from "../../../utils/id-generators";
+/** Runtime-accessible product status values — use instead of bare string literals. */
+export const ProductStatusValues = {
+    DRAFT: "draft",
+    PUBLISHED: "published",
+    ARCHIVED: "archived",
+    SOLD: "sold",
+    OUT_OF_STOCK: "out_of_stock",
+    DISCONTINUED: "discontinued",
+};
+export const PRODUCT_COLLECTION = "products";
+export const PRODUCT_INDEXED_FIELDS = [
+    "sellerId",
+    "status",
+    "category",
+    "featured",
+    "isAuction",
+    "isPreOrder",
+    "isPromoted",
+    "createdAt",
+];
+export const DEFAULT_PRODUCT_DATA = {
+    status: "draft",
+    featured: false,
+    images: [],
+    tags: [],
+    availableQuantity: 0,
+    isAuction: false,
+    isPreOrder: false,
+    isPromoted: false,
+    bidCount: 0,
+    condition: "new",
+    insurance: false,
+    shippingPaidBy: "buyer",
+    autoExtendable: false,
+    auctionExtensionMinutes: 5,
+    auctionShippingPaidBy: "winner",
+};
+export const PRODUCT_PUBLIC_FIELDS = [
+    "id",
+    "title",
+    "description",
+    "category",
+    "subcategory",
+    "brand",
+    "price",
+    "currency",
+    "stockQuantity",
+    "availableQuantity",
+    "images",
+    "status",
+    "sellerName",
+    "featured",
+    "tags",
+    "specifications",
+    "features",
+    "shippingInfo",
+    "returnPolicy",
+    "isAuction",
+    "auctionEndDate",
+    "startingBid",
+    "currentBid",
+    "bidCount",
+    "reservePrice",
+    "buyNowPrice",
+    "minBidIncrement",
+    "autoExtendable",
+    "auctionExtensionMinutes",
+    "auctionShippingPaidBy",
+    "isPreOrder",
+    "preOrderDeliveryDate",
+    "preOrderDepositPercent",
+    "preOrderDepositAmount",
+    "preOrderMaxQuantity",
+    "preOrderCurrentCount",
+    "preOrderProductionStatus",
+    "preOrderCancellable",
+    "condition",
+    "insurance",
+    "insuranceCost",
+    "shippingPaidBy",
+    "isPromoted",
+    "slug",
+    "seoTitle",
+    "seoDescription",
+    "seoKeywords",
+    "viewCount",
+    "createdAt",
+];
+export const PRODUCT_UPDATABLE_FIELDS = [
+    "title",
+    "description",
+    "category",
+    "subcategory",
+    "brand",
+    "price",
+    "stockQuantity",
+    "images",
+    "status",
+    "tags",
+    "specifications",
+    "features",
+    "shippingInfo",
+    "returnPolicy",
+    "pickupAddressId",
+    "condition",
+    "insurance",
+    "shippingPaidBy",
+    "autoExtendable",
+    "auctionExtensionMinutes",
+    "auctionShippingPaidBy",
+    "reservePrice",
+    "buyNowPrice",
+    "minBidIncrement",
+    "isPreOrder",
+    "preOrderDeliveryDate",
+    "preOrderDepositPercent",
+    "preOrderDepositAmount",
+    "preOrderMaxQuantity",
+    "preOrderProductionStatus",
+    "preOrderCancellable",
+    "seoTitle",
+    "seoDescription",
+    "seoKeywords",
+];
+export const productQueryHelpers = {
+    bySeller: (sellerId) => ["sellerId", "==", sellerId],
+    byStatus: (status) => ["status", "==", status],
+    byCategory: (category) => ["category", "==", category],
+    featured: () => ["featured", "==", true],
+    published: () => ["status", "==", "published"],
+    available: () => ["availableQuantity", ">", 0],
+    auctions: () => ["isAuction", "==", true],
+    preOrders: () => ["isPreOrder", "==", true],
+    promoted: () => ["isPromoted", "==", true],
+    activeAuction: (date) => ["auctionEndDate", ">=", date],
+};
+export function createProductId(input) {
+    return generateProductId(input);
+}
+export function createAuctionId(input) {
+    return generateAuctionId(input);
+}
+export function createPreOrderId(input) {
+    return generatePreOrderId(input);
+}

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

@@ -0,0 +1,400 @@
+export * from "./firestore";
+import { z } from "zod";
+export declare const productImageSchema: z.ZodObject<{
+    url: z.ZodString;
+    thumbnailUrl: z.ZodOptional<z.ZodString>;
+    alt: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    alt?: string | undefined;
+    order?: number | undefined;
+    thumbnailUrl?: string | undefined;
+}, {
+    url: string;
+    alt?: string | undefined;
+    order?: number | undefined;
+    thumbnailUrl?: string | undefined;
+}>;
+export declare const productSeoSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    title?: string | undefined;
+    description?: string | undefined;
+    keywords?: string[] | undefined;
+}, {
+    title?: string | undefined;
+    description?: string | undefined;
+    keywords?: string[] | undefined;
+}>;
+/**
+ * Base Zod schema for a product item.
+ * Apps can extend this to add their own fields:
+ *
+ * @example
+ * import { productItemSchema } from "@mohasinac/feat-products";
+ *
+ * const myProductSchema = productItemSchema.extend({
+ *   brand: z.string(),
+ *   auctionEndDate: z.string().optional(),
+ * });
+ * type MyProduct = z.infer<typeof myProductSchema>;
+ */
+export declare const productItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    price: z.ZodNumber;
+    originalPrice: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodOptional<z.ZodString>;
+    mainImage: z.ZodOptional<z.ZodString>;
+    images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        type: z.ZodEnum<["image", "video", "file"]>;
+        alt: z.ZodOptional<z.ZodString>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        type: "video" | "image" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+    }, {
+        url: string;
+        type: "video" | "image" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+    }>, "many">>;
+    video: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        thumbnailUrl?: string | undefined;
+    }, {
+        url: string;
+        thumbnailUrl?: string | undefined;
+    }>>;
+    featured: z.ZodOptional<z.ZodBoolean>;
+    isPromoted: z.ZodOptional<z.ZodBoolean>;
+    currentBid: z.ZodOptional<z.ZodNumber>;
+    availableQuantity: z.ZodOptional<z.ZodNumber>;
+    category: z.ZodOptional<z.ZodString>;
+    categorySlug: z.ZodOptional<z.ZodString>;
+    sellerId: z.ZodOptional<z.ZodString>;
+    sellerName: z.ZodOptional<z.ZodString>;
+    sellerAvatar: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["draft", "published", "archived", "sold", "out_of_stock", "discontinued"]>;
+    condition: z.ZodOptional<z.ZodEnum<["new", "like_new", "good", "fair", "poor", "used", "refurbished", "broken"]>>;
+    listingType: z.ZodOptional<z.ZodEnum<["fixed", "standard", "auction", "pre-order"]>>;
+    isAuction: z.ZodOptional<z.ZodBoolean>;
+    isPreOrder: z.ZodOptional<z.ZodBoolean>;
+    inStock: z.ZodOptional<z.ZodBoolean>;
+    stockCount: z.ZodOptional<z.ZodNumber>;
+    rating: z.ZodOptional<z.ZodNumber>;
+    reviewCount: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    seo: z.ZodOptional<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        title?: string | undefined;
+        description?: string | undefined;
+        keywords?: string[] | undefined;
+    }, {
+        title?: string | undefined;
+        description?: string | undefined;
+        keywords?: string[] | undefined;
+    }>>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    publishedAt: z.ZodOptional<z.ZodString>;
+    stockQuantity: z.ZodOptional<z.ZodNumber>;
+    subcategory: z.ZodOptional<z.ZodString>;
+    brand: z.ZodOptional<z.ZodString>;
+    storeId: z.ZodOptional<z.ZodString>;
+    sellerEmail: z.ZodOptional<z.ZodString>;
+    specifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+        unit: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        name: string;
+        unit?: string | undefined;
+    }, {
+        value: string;
+        name: string;
+        unit?: string | undefined;
+    }>, "many">>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    shippingInfo: z.ZodOptional<z.ZodString>;
+    returnPolicy: z.ZodOptional<z.ZodString>;
+    ingredients: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    howToUse: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    allowOffers: z.ZodOptional<z.ZodBoolean>;
+    minOfferPercent: z.ZodOptional<z.ZodNumber>;
+    bulkDiscounts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        quantity: z.ZodNumber;
+        discountPercent: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        discountPercent: number;
+        quantity: number;
+    }, {
+        discountPercent: number;
+        quantity: number;
+    }>, "many">>;
+    startingBid: z.ZodOptional<z.ZodNumber>;
+    bidCount: z.ZodOptional<z.ZodNumber>;
+    auctionEndDate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
+    reservePrice: z.ZodOptional<z.ZodNumber>;
+    buyNowPrice: z.ZodOptional<z.ZodNumber>;
+    minBidIncrement: z.ZodOptional<z.ZodNumber>;
+    autoExtendable: z.ZodOptional<z.ZodBoolean>;
+    auctionExtensionMinutes: z.ZodOptional<z.ZodNumber>;
+    auctionShippingPaidBy: z.ZodOptional<z.ZodEnum<["seller", "winner"]>>;
+    preOrderDeliveryDate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
+    preOrderDepositPercent: z.ZodOptional<z.ZodNumber>;
+    preOrderDepositAmount: z.ZodOptional<z.ZodNumber>;
+    preOrderMaxQuantity: z.ZodOptional<z.ZodNumber>;
+    preOrderCurrentCount: z.ZodOptional<z.ZodNumber>;
+    preOrderProductionStatus: z.ZodOptional<z.ZodEnum<["upcoming", "in_production", "ready_to_ship"]>>;
+    preOrderCancellable: z.ZodOptional<z.ZodBoolean>;
+    viewCount: z.ZodOptional<z.ZodNumber>;
+    avgRating: z.ZodOptional<z.ZodNumber>;
+    shippingPaidBy: z.ZodOptional<z.ZodEnum<["seller", "buyer"]>>;
+    pickupAddressId: z.ZodOptional<z.ZodString>;
+    insurance: z.ZodOptional<z.ZodBoolean>;
+    insuranceCost: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    status: "draft" | "published" | "archived" | "out_of_stock" | "discontinued" | "sold";
+    price: number;
+    video?: {
+        url: string;
+        thumbnailUrl?: string | undefined;
+    } | undefined;
+    media?: {
+        url: string;
+        type: "video" | "image" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+    }[] | undefined;
+    createdAt?: string | undefined;
+    updatedAt?: string | undefined;
+    category?: string | undefined;
+    sellerId?: string | undefined;
+    sellerName?: string | undefined;
+    sellerEmail?: string | undefined;
+    currency?: string | undefined;
+    images?: string[] | undefined;
+    rating?: number | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    seo?: {
+        title?: string | undefined;
+        description?: string | undefined;
+        keywords?: string[] | undefined;
+    } | undefined;
+    features?: string[] | undefined;
+    slug?: string | undefined;
+    featured?: boolean | undefined;
+    storeId?: string | undefined;
+    isAuction?: boolean | undefined;
+    isPreOrder?: boolean | undefined;
+    attributes?: Record<string, string> | undefined;
+    categorySlug?: string | undefined;
+    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
+    inStock?: boolean | undefined;
+    brand?: string | undefined;
+    currentBid?: number | undefined;
+    startingBid?: number | undefined;
+    auctionEndDate?: string | Date | undefined;
+    preOrderDeliveryDate?: string | Date | undefined;
+    originalPrice?: number | undefined;
+    mainImage?: string | undefined;
+    isPromoted?: boolean | undefined;
+    availableQuantity?: number | undefined;
+    sellerAvatar?: string | undefined;
+    listingType?: "fixed" | "standard" | "auction" | "pre-order" | undefined;
+    stockCount?: number | undefined;
+    reviewCount?: number | undefined;
+    publishedAt?: string | undefined;
+    stockQuantity?: number | undefined;
+    subcategory?: string | undefined;
+    specifications?: {
+        value: string;
+        name: string;
+        unit?: string | undefined;
+    }[] | undefined;
+    shippingInfo?: string | undefined;
+    returnPolicy?: string | undefined;
+    ingredients?: string[] | undefined;
+    howToUse?: string[] | undefined;
+    allowOffers?: boolean | undefined;
+    minOfferPercent?: number | undefined;
+    bulkDiscounts?: {
+        discountPercent: number;
+        quantity: number;
+    }[] | undefined;
+    bidCount?: number | undefined;
+    reservePrice?: number | undefined;
+    buyNowPrice?: number | undefined;
+    minBidIncrement?: number | undefined;
+    autoExtendable?: boolean | undefined;
+    auctionExtensionMinutes?: number | undefined;
+    auctionShippingPaidBy?: "seller" | "winner" | undefined;
+    preOrderDepositPercent?: number | undefined;
+    preOrderDepositAmount?: number | undefined;
+    preOrderMaxQuantity?: number | undefined;
+    preOrderCurrentCount?: number | undefined;
+    preOrderProductionStatus?: "upcoming" | "in_production" | "ready_to_ship" | undefined;
+    preOrderCancellable?: boolean | undefined;
+    viewCount?: number | undefined;
+    avgRating?: number | undefined;
+    shippingPaidBy?: "seller" | "buyer" | undefined;
+    pickupAddressId?: string | undefined;
+    insurance?: boolean | undefined;
+    insuranceCost?: number | undefined;
+}, {
+    id: string;
+    title: string;
+    status: "draft" | "published" | "archived" | "out_of_stock" | "discontinued" | "sold";
+    price: number;
+    video?: {
+        url: string;
+        thumbnailUrl?: string | undefined;
+    } | undefined;
+    media?: {
+        url: string;
+        type: "video" | "image" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+    }[] | undefined;
+    createdAt?: string | undefined;
+    updatedAt?: string | undefined;
+    category?: string | undefined;
+    sellerId?: string | undefined;
+    sellerName?: string | undefined;
+    sellerEmail?: string | undefined;
+    currency?: string | undefined;
+    images?: string[] | undefined;
+    rating?: number | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    seo?: {
+        title?: string | undefined;
+        description?: string | undefined;
+        keywords?: string[] | undefined;
+    } | undefined;
+    features?: string[] | undefined;
+    slug?: string | undefined;
+    featured?: boolean | undefined;
+    storeId?: string | undefined;
+    isAuction?: boolean | undefined;
+    isPreOrder?: boolean | undefined;
+    attributes?: Record<string, string> | undefined;
+    categorySlug?: string | undefined;
+    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
+    inStock?: boolean | undefined;
+    brand?: string | undefined;
+    currentBid?: number | undefined;
+    startingBid?: number | undefined;
+    auctionEndDate?: string | Date | undefined;
+    preOrderDeliveryDate?: string | Date | undefined;
+    originalPrice?: number | undefined;
+    mainImage?: string | undefined;
+    isPromoted?: boolean | undefined;
+    availableQuantity?: number | undefined;
+    sellerAvatar?: string | undefined;
+    listingType?: "fixed" | "standard" | "auction" | "pre-order" | undefined;
+    stockCount?: number | undefined;
+    reviewCount?: number | undefined;
+    publishedAt?: string | undefined;
+    stockQuantity?: number | undefined;
+    subcategory?: string | undefined;
+    specifications?: {
+        value: string;
+        name: string;
+        unit?: string | undefined;
+    }[] | undefined;
+    shippingInfo?: string | undefined;
+    returnPolicy?: string | undefined;
+    ingredients?: string[] | undefined;
+    howToUse?: string[] | undefined;
+    allowOffers?: boolean | undefined;
+    minOfferPercent?: number | undefined;
+    bulkDiscounts?: {
+        discountPercent: number;
+        quantity: number;
+    }[] | undefined;
+    bidCount?: number | undefined;
+    reservePrice?: number | undefined;
+    buyNowPrice?: number | undefined;
+    minBidIncrement?: number | undefined;
+    autoExtendable?: boolean | undefined;
+    auctionExtensionMinutes?: number | undefined;
+    auctionShippingPaidBy?: "seller" | "winner" | undefined;
+    preOrderDepositPercent?: number | undefined;
+    preOrderDepositAmount?: number | undefined;
+    preOrderMaxQuantity?: number | undefined;
+    preOrderCurrentCount?: number | undefined;
+    preOrderProductionStatus?: "upcoming" | "in_production" | "ready_to_ship" | undefined;
+    preOrderCancellable?: boolean | undefined;
+    viewCount?: number | undefined;
+    avgRating?: number | undefined;
+    shippingPaidBy?: "seller" | "buyer" | undefined;
+    pickupAddressId?: string | undefined;
+    insurance?: boolean | undefined;
+    insuranceCost?: number | undefined;
+}>;
+/** Base Zod schema for list-query parameters. */
+export declare const productListParamsSchema: z.ZodObject<{
+    q: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<["draft", "published", "archived", "sold", "out_of_stock", "discontinued"]>>;
+    condition: z.ZodOptional<z.ZodEnum<["new", "like_new", "good", "fair", "poor", "used", "refurbished", "broken"]>>;
+    minPrice: z.ZodOptional<z.ZodNumber>;
+    maxPrice: z.ZodOptional<z.ZodNumber>;
+    inStock: z.ZodOptional<z.ZodBoolean>;
+    isAuction: z.ZodOptional<z.ZodBoolean>;
+    sellerId: z.ZodOptional<z.ZodString>;
+    sort: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    featured: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    sort?: string | undefined;
+    q?: string | undefined;
+    status?: "draft" | "published" | "archived" | "out_of_stock" | "discontinued" | "sold" | undefined;
+    page?: number | undefined;
+    category?: string | undefined;
+    minPrice?: number | undefined;
+    maxPrice?: number | undefined;
+    perPage?: number | undefined;
+    sellerId?: string | undefined;
+    featured?: boolean | undefined;
+    isAuction?: boolean | undefined;
+    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
+    inStock?: boolean | undefined;
+}, {
+    sort?: string | undefined;
+    q?: string | undefined;
+    status?: "draft" | "published" | "archived" | "out_of_stock" | "discontinued" | "sold" | undefined;
+    page?: number | undefined;
+    category?: string | undefined;
+    minPrice?: number | undefined;
+    maxPrice?: number | undefined;
+    perPage?: number | undefined;
+    sellerId?: string | undefined;
+    featured?: boolean | undefined;
+    isAuction?: boolean | undefined;
+    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
+    inStock?: boolean | undefined;
+}>;