@mohasinac/appkit 2.4.10 → 2.5.0

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

@@ -63,7 +63,6 @@ export interface ProductDocument {
     insurance?: boolean;
     insuranceCost?: number;
     shippingPaidBy?: "seller" | "buyer";
-    isAuction?: boolean;
     auctionEndDate?: Date;
     startingBid?: number;
     currentBid?: number;
@@ -75,7 +74,6 @@ export interface ProductDocument {
     auctionExtensionMinutes?: number;
     auctionOriginalEndDate?: Date;
     auctionShippingPaidBy?: "seller" | "winner";
-    isPreOrder?: boolean;
     preOrderDeliveryDate?: Date;
     preOrderDepositPercent?: number;
     preOrderDepositAmount?: number;
@@ -107,9 +105,49 @@ export interface ProductDocument {
     groupParentSlug?: string;
     groupChildSlugs?: string[];
     groupTitle?: string;
+    /**
+     * Required since Phase 4 dropped the legacy `isAuction` / `isPreOrder`
+     * booleans. Every product document carries this; queries route through
+     * `where("listingType", "==", X)` against the `listingType+...` composite
+     * indexes in `appkit/firebase/base/firestore.indexes.json`.
+     */
+    listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
+    /** Hard cap on units a single user may purchase (SB1-B; bundle/prize-draw). */
+    maxPerUser?: number;
+    /** Reverse pointers — bundle ids that include this product. */
+    partOfBundleIds?: string[];
+    partOfBundleTitles?: string[];
+    prizeDrawItems?: PrizeDrawItem[];
+    pricePerEntry?: number;
+    prizeMaxEntries?: number;
+    prizeCurrentEntries?: number;
+    prizeRevealWindowStart?: Date;
+    prizeRevealWindowEnd?: Date;
+    prizeRevealStatus?: "pending" | "open" | "closed";
+    prizeRevealDeadlineDays?: number;
+    /** Public proof-of-fairness file (commit-reveal scheme). */
+    prizeGithubFileUrl?: string;
     createdAt: Date;
     updatedAt: Date;
 }
+/**
+ * Single prize within a prize-draw listing. A draw can have between 3 and 16
+ * prizes; each is revealed in `itemNumber` order during the reveal window.
+ * `isWon` flips to `true` when the draw assigns this prize to a participant.
+ */
+export interface PrizeDrawItem {
+    itemNumber: number;
+    title: string;
+    description?: string;
+    images: string[];
+    video?: {
+        url: string;
+        thumbnailUrl?: string;
+    };
+    condition: string;
+    estimatedValue?: number;
+    isWon: boolean;
+}
 /** Runtime-accessible product status values — use instead of bare string literals. */
 export declare const ProductStatusValues: {
     readonly DRAFT: "draft";
@@ -120,10 +158,10 @@ export declare const ProductStatusValues: {
     readonly DISCONTINUED: "discontinued";
 };
 export declare const PRODUCT_COLLECTION: "products";
-export declare const PRODUCT_INDEXED_FIELDS: readonly ["storeId", "status", "category", "featured", "isAuction", "isPreOrder", "isPromoted", "isOnSale", "isSold", "createdAt"];
+export declare const PRODUCT_INDEXED_FIELDS: readonly ["storeId", "status", "category", "featured", "listingType", "isPromoted", "isOnSale", "isSold", "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", "storeName", "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", "isOnSale", "isSold", "slug", "seoTitle", "seoDescription", "seoKeywords", "viewCount", "customFields", "customSections", "sublistingCategoryId", "groupId", "isGroupParent", "groupParentSlug", "groupChildSlugs", "groupTitle", "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", "isOnSale", "isSold", "seoTitle", "seoDescription", "seoKeywords", "customFields", "customSections", "sublistingCategoryId", "groupId", "isGroupParent", "groupParentSlug", "groupChildSlugs", "groupTitle"];
+export declare const PRODUCT_PUBLIC_FIELDS: readonly ["id", "title", "description", "category", "subcategory", "brand", "price", "currency", "stockQuantity", "availableQuantity", "images", "status", "storeName", "featured", "tags", "specifications", "features", "shippingInfo", "returnPolicy", "listingType", "auctionEndDate", "startingBid", "currentBid", "bidCount", "reservePrice", "buyNowPrice", "minBidIncrement", "autoExtendable", "auctionExtensionMinutes", "auctionShippingPaidBy", "preOrderDeliveryDate", "preOrderDepositPercent", "preOrderDepositAmount", "preOrderMaxQuantity", "preOrderCurrentCount", "preOrderProductionStatus", "preOrderCancellable", "condition", "insurance", "insuranceCost", "shippingPaidBy", "isPromoted", "isOnSale", "isSold", "slug", "seoTitle", "seoDescription", "seoKeywords", "viewCount", "customFields", "customSections", "sublistingCategoryId", "groupId", "isGroupParent", "groupParentSlug", "groupChildSlugs", "groupTitle", "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", "listingType", "preOrderDeliveryDate", "preOrderDepositPercent", "preOrderDepositAmount", "preOrderMaxQuantity", "preOrderProductionStatus", "preOrderCancellable", "isOnSale", "isSold", "seoTitle", "seoDescription", "seoKeywords", "customFields", "customSections", "sublistingCategoryId", "groupId", "isGroupParent", "groupParentSlug", "groupChildSlugs", "groupTitle"];
 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">>;

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

@@ -19,8 +19,7 @@ export const PRODUCT_INDEXED_FIELDS = [
     "status",
     "category",
     "featured",
-    "isAuction",
-    "isPreOrder",
+    "listingType",
     "isPromoted",
     "isOnSale",
     "isSold",
@@ -32,8 +31,9 @@ export const DEFAULT_PRODUCT_DATA = {
     images: [],
     tags: [],
     availableQuantity: 0,
-    isAuction: false,
-    isPreOrder: false,
+    // SB1-G Phase 4 — listingType is the canonical discriminator. Defaults to
+    // "standard"; the editor flips it when the seller chooses auction or pre-order.
+    listingType: "standard",
     isPromoted: false,
     isOnSale: false,
     isSold: false,
@@ -65,7 +65,7 @@ export const PRODUCT_PUBLIC_FIELDS = [
     "features",
     "shippingInfo",
     "returnPolicy",
-    "isAuction",
+    "listingType",
     "auctionEndDate",
     "startingBid",
     "currentBid",
@@ -76,7 +76,6 @@ export const PRODUCT_PUBLIC_FIELDS = [
     "autoExtendable",
     "auctionExtensionMinutes",
     "auctionShippingPaidBy",
-    "isPreOrder",
     "preOrderDeliveryDate",
     "preOrderDepositPercent",
     "preOrderDepositAmount",
@@ -131,7 +130,7 @@ export const PRODUCT_UPDATABLE_FIELDS = [
     "reservePrice",
     "buyNowPrice",
     "minBidIncrement",
-    "isPreOrder",
+    "listingType",
     "preOrderDeliveryDate",
     "preOrderDepositPercent",
     "preOrderDepositAmount",

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

@@ -60,15 +60,15 @@ export declare const productItemSchema: z.ZodObject<{
         source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
         youtubeId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        url: string;
         type: "video" | "image" | "file";
+        url: string;
         source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
         youtubeId?: string | undefined;
     }, {
-        url: string;
         type: "video" | "image" | "file";
+        url: string;
         source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
@@ -93,9 +93,61 @@ export declare const productItemSchema: z.ZodObject<{
     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>;
+    listingType: z.ZodOptional<z.ZodEnum<["standard", "auction", "pre-order", "prize-draw", "bundle"]>>;
+    maxPerUser: z.ZodOptional<z.ZodNumber>;
+    partOfBundleIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    partOfBundleTitles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    prizeDrawItems: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        itemNumber: z.ZodNumber;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        images: z.ZodArray<z.ZodString, "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;
+        }>>;
+        condition: z.ZodString;
+        estimatedValue: z.ZodOptional<z.ZodNumber>;
+        isWon: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        images: string[];
+        condition: string;
+        itemNumber: number;
+        isWon: boolean;
+        video?: {
+            url: string;
+            thumbnailUrl?: string | undefined;
+        } | undefined;
+        description?: string | undefined;
+        estimatedValue?: number | undefined;
+    }, {
+        title: string;
+        images: string[];
+        condition: string;
+        itemNumber: number;
+        isWon: boolean;
+        video?: {
+            url: string;
+            thumbnailUrl?: string | undefined;
+        } | undefined;
+        description?: string | undefined;
+        estimatedValue?: number | undefined;
+    }>, "many">>;
+    pricePerEntry: z.ZodOptional<z.ZodNumber>;
+    prizeMaxEntries: z.ZodOptional<z.ZodNumber>;
+    prizeCurrentEntries: z.ZodOptional<z.ZodNumber>;
+    prizeRevealWindowStart: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
+    prizeRevealWindowEnd: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
+    prizeRevealStatus: z.ZodOptional<z.ZodEnum<["pending", "open", "closed"]>>;
+    prizeRevealDeadlineDays: z.ZodOptional<z.ZodNumber>;
+    prizeGithubFileUrl: z.ZodOptional<z.ZodString>;
     inStock: z.ZodOptional<z.ZodBoolean>;
     stockCount: z.ZodOptional<z.ZodNumber>;
     rating: z.ZodOptional<z.ZodNumber>;
@@ -233,54 +285,48 @@ export declare const productItemSchema: z.ZodObject<{
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     id: string;
+    status: "draft" | "published" | "archived" | "sold" | "out_of_stock" | "discontinued";
     title: string;
-    status: "draft" | "published" | "archived" | "out_of_stock" | "discontinued" | "sold";
     price: number;
+    currency?: string | undefined;
+    createdAt?: string | undefined;
+    updatedAt?: string | undefined;
+    storeId?: string | undefined;
     video?: {
         url: string;
         thumbnailUrl?: string | undefined;
     } | undefined;
     media?: {
-        url: string;
         type: "video" | "image" | "file";
+        url: string;
         source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
         youtubeId?: string | undefined;
     }[] | undefined;
-    createdAt?: string | undefined;
-    updatedAt?: string | undefined;
     category?: string | undefined;
-    storeId?: string | undefined;
-    currency?: string | undefined;
     images?: string[] | undefined;
     rating?: number | undefined;
     description?: string | undefined;
-    tags?: string[] | undefined;
-    slug?: string | undefined;
-    seo?: {
-        title?: string | undefined;
-        description?: string | undefined;
-        keywords?: string[] | undefined;
-    } | undefined;
-    features?: string[] | undefined;
     featured?: boolean | undefined;
+    listingType?: "auction" | "standard" | "pre-order" | "prize-draw" | "bundle" | undefined;
     isPromoted?: boolean | undefined;
-    isAuction?: boolean | undefined;
-    isPreOrder?: boolean | undefined;
+    slug?: string | undefined;
     subcategory?: string | undefined;
     brand?: string | undefined;
     stockQuantity?: number | undefined;
     availableQuantity?: number | undefined;
     mainImage?: string | undefined;
+    tags?: string[] | undefined;
     specifications?: {
         value: string;
         name: string;
         unit?: string | undefined;
     }[] | undefined;
+    features?: string[] | undefined;
     shippingInfo?: string | undefined;
     returnPolicy?: string | undefined;
-    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
+    condition?: "new" | "used" | "refurbished" | "fair" | "good" | "like_new" | "poor" | "broken" | undefined;
     insurance?: boolean | undefined;
     insuranceCost?: number | undefined;
     shippingPaidBy?: "seller" | "buyer" | undefined;
@@ -330,64 +376,86 @@ export declare const productItemSchema: z.ZodObject<{
             unit?: string | undefined;
         }[] | undefined;
     }[] | undefined;
+    maxPerUser?: number | undefined;
+    partOfBundleIds?: string[] | undefined;
+    partOfBundleTitles?: string[] | undefined;
+    prizeDrawItems?: {
+        title: string;
+        images: string[];
+        condition: string;
+        itemNumber: number;
+        isWon: boolean;
+        video?: {
+            url: string;
+            thumbnailUrl?: string | undefined;
+        } | undefined;
+        description?: string | undefined;
+        estimatedValue?: number | undefined;
+    }[] | undefined;
+    pricePerEntry?: number | undefined;
+    prizeMaxEntries?: number | undefined;
+    prizeCurrentEntries?: number | undefined;
+    prizeRevealWindowStart?: string | Date | undefined;
+    prizeRevealWindowEnd?: string | Date | undefined;
+    prizeRevealStatus?: "pending" | "closed" | "open" | undefined;
+    prizeRevealDeadlineDays?: number | undefined;
+    prizeGithubFileUrl?: string | undefined;
     originalPrice?: number | undefined;
     categorySlug?: string | undefined;
     sellerAvatar?: string | undefined;
-    listingType?: "fixed" | "auction" | "standard" | "pre-order" | undefined;
     inStock?: boolean | undefined;
     stockCount?: number | undefined;
     attributes?: Record<string, string> | undefined;
+    seo?: {
+        title?: string | undefined;
+        description?: string | undefined;
+        keywords?: string[] | undefined;
+    } | undefined;
     publishedAt?: string | undefined;
 }, {
     id: string;
+    status: "draft" | "published" | "archived" | "sold" | "out_of_stock" | "discontinued";
     title: string;
-    status: "draft" | "published" | "archived" | "out_of_stock" | "discontinued" | "sold";
     price: number;
+    currency?: string | undefined;
+    createdAt?: string | undefined;
+    updatedAt?: string | undefined;
+    storeId?: string | undefined;
     video?: {
         url: string;
         thumbnailUrl?: string | undefined;
     } | undefined;
     media?: {
-        url: string;
         type: "video" | "image" | "file";
+        url: string;
         source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
         youtubeId?: string | undefined;
     }[] | undefined;
-    createdAt?: string | undefined;
-    updatedAt?: string | undefined;
     category?: string | undefined;
-    storeId?: string | undefined;
-    currency?: string | undefined;
     images?: string[] | undefined;
     rating?: number | undefined;
     description?: string | undefined;
-    tags?: string[] | undefined;
-    slug?: string | undefined;
-    seo?: {
-        title?: string | undefined;
-        description?: string | undefined;
-        keywords?: string[] | undefined;
-    } | undefined;
-    features?: string[] | undefined;
     featured?: boolean | undefined;
+    listingType?: "auction" | "standard" | "pre-order" | "prize-draw" | "bundle" | undefined;
     isPromoted?: boolean | undefined;
-    isAuction?: boolean | undefined;
-    isPreOrder?: boolean | undefined;
+    slug?: string | undefined;
     subcategory?: string | undefined;
     brand?: string | undefined;
     stockQuantity?: number | undefined;
     availableQuantity?: number | undefined;
     mainImage?: string | undefined;
+    tags?: string[] | undefined;
     specifications?: {
         value: string;
         name: string;
         unit?: string | undefined;
     }[] | undefined;
+    features?: string[] | undefined;
     shippingInfo?: string | undefined;
     returnPolicy?: string | undefined;
-    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
+    condition?: "new" | "used" | "refurbished" | "fair" | "good" | "like_new" | "poor" | "broken" | undefined;
     insurance?: boolean | undefined;
     insuranceCost?: number | undefined;
     shippingPaidBy?: "seller" | "buyer" | undefined;
@@ -437,13 +505,41 @@ export declare const productItemSchema: z.ZodObject<{
             unit?: string | undefined;
         }[] | undefined;
     }[] | undefined;
+    maxPerUser?: number | undefined;
+    partOfBundleIds?: string[] | undefined;
+    partOfBundleTitles?: string[] | undefined;
+    prizeDrawItems?: {
+        title: string;
+        images: string[];
+        condition: string;
+        itemNumber: number;
+        isWon: boolean;
+        video?: {
+            url: string;
+            thumbnailUrl?: string | undefined;
+        } | undefined;
+        description?: string | undefined;
+        estimatedValue?: number | undefined;
+    }[] | undefined;
+    pricePerEntry?: number | undefined;
+    prizeMaxEntries?: number | undefined;
+    prizeCurrentEntries?: number | undefined;
+    prizeRevealWindowStart?: string | Date | undefined;
+    prizeRevealWindowEnd?: string | Date | undefined;
+    prizeRevealStatus?: "pending" | "closed" | "open" | undefined;
+    prizeRevealDeadlineDays?: number | undefined;
+    prizeGithubFileUrl?: string | undefined;
     originalPrice?: number | undefined;
     categorySlug?: string | undefined;
     sellerAvatar?: string | undefined;
-    listingType?: "fixed" | "auction" | "standard" | "pre-order" | undefined;
     inStock?: boolean | undefined;
     stockCount?: number | undefined;
     attributes?: Record<string, string> | undefined;
+    seo?: {
+        title?: string | undefined;
+        description?: string | undefined;
+        keywords?: string[] | undefined;
+    } | undefined;
     publishedAt?: string | undefined;
 }>;
 /** Base Zod schema for list-query parameters. */
@@ -463,30 +559,30 @@ export declare const productListParamsSchema: z.ZodObject<{
     featured: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     sort?: string | undefined;
+    perPage?: number | undefined;
+    storeId?: string | undefined;
+    status?: "draft" | "published" | "archived" | "sold" | "out_of_stock" | "discontinued" | undefined;
     q?: string | undefined;
-    status?: "draft" | "published" | "archived" | "out_of_stock" | "discontinued" | "sold" | undefined;
-    category?: string | undefined;
     page?: number | undefined;
+    category?: string | undefined;
     minPrice?: number | undefined;
     maxPrice?: number | undefined;
-    perPage?: number | undefined;
-    storeId?: string | undefined;
     featured?: boolean | undefined;
+    condition?: "new" | "used" | "refurbished" | "fair" | "good" | "like_new" | "poor" | "broken" | undefined;
     isAuction?: boolean | undefined;
-    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
     inStock?: boolean | undefined;
 }, {
     sort?: string | undefined;
+    perPage?: number | undefined;
+    storeId?: string | undefined;
+    status?: "draft" | "published" | "archived" | "sold" | "out_of_stock" | "discontinued" | undefined;
     q?: string | undefined;
-    status?: "draft" | "published" | "archived" | "out_of_stock" | "discontinued" | "sold" | undefined;
-    category?: string | undefined;
     page?: number | undefined;
+    category?: string | undefined;
     minPrice?: number | undefined;
     maxPrice?: number | undefined;
-    perPage?: number | undefined;
-    storeId?: string | undefined;
     featured?: boolean | undefined;
+    condition?: "new" | "used" | "refurbished" | "fair" | "good" | "like_new" | "poor" | "broken" | undefined;
     isAuction?: boolean | undefined;
-    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
     inStock?: boolean | undefined;
 }>;

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

@@ -68,9 +68,38 @@ export const productItemSchema = z.object({
         "broken",
     ])
         .optional(),
-    listingType: z.enum(["fixed", "standard", "auction", "pre-order"]).optional(),
-    isAuction: z.boolean().optional(),
-    isPreOrder: z.boolean().optional(),
+    // SB1-G Phase 4 — canonical discriminator (legacy `isAuction`/`isPreOrder` booleans removed).
+    listingType: z
+        .enum(["standard", "auction", "pre-order", "prize-draw", "bundle"])
+        .optional(),
+    // SB1-C — prize-draw + bundle fields. All optional.
+    maxPerUser: z.number().int().positive().optional(),
+    partOfBundleIds: z.array(z.string()).optional(),
+    partOfBundleTitles: z.array(z.string()).optional(),
+    prizeDrawItems: z
+        .array(z.object({
+        itemNumber: z.number().int().positive(),
+        title: z.string().min(1),
+        description: z.string().optional(),
+        images: z.array(z.string()).min(1).max(2),
+        video: z
+            .object({ url: z.string(), thumbnailUrl: z.string().optional() })
+            .optional(),
+        condition: z.string(),
+        estimatedValue: z.number().optional(),
+        isWon: z.boolean(),
+    }))
+        .min(3)
+        .max(16)
+        .optional(),
+    pricePerEntry: z.number().positive().optional(),
+    prizeMaxEntries: z.number().int().positive().optional(),
+    prizeCurrentEntries: z.number().int().nonnegative().optional(),
+    prizeRevealWindowStart: z.union([z.string(), z.date()]).optional(),
+    prizeRevealWindowEnd: z.union([z.string(), z.date()]).optional(),
+    prizeRevealStatus: z.enum(["pending", "open", "closed"]).optional(),
+    prizeRevealDeadlineDays: z.number().int().positive().optional(),
+    prizeGithubFileUrl: z.string().url().optional(),
     inStock: z.boolean().optional(),
     stockCount: z.number().optional(),
     rating: z.number().optional(),

package/dist/features/products/schemas/product-features.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Product Features — Firestore schema
+ *
+ * A productFeature is a reusable badge that products opt into via product.features[].
+ * Two scopes:
+ *   - "platform": admin-curated, available to every store
+ *   - "store":    seller-owned, scoped to one storeId, capped at MAX_STORE_CUSTOM_FEATURES
+ *
+ * id === slug, prefix "feature-".
+ *
+ * The icon field accepts either:
+ *   - a name key from the appkit icon set (e.g. "truck", "badge-check", "trophy"), or
+ *   - a raw SVG path-d string starting with "M " (rare; for store custom icons).
+ *
+ * MAX_FEATURES_PER_PRODUCT — hard cap on product.features[].length, enforced by FI5 form.
+ */
+export declare const PRODUCT_FEATURES_COLLECTION: "productFeatures";
+export declare const PRODUCT_FEATURE_PREFIX: "feature-";
+export declare const MAX_STORE_CUSTOM_FEATURES = 20;
+export declare const MAX_FEATURES_PER_PRODUCT = 10;
+export type ProductFeatureScope = "platform" | "store";
+export type ProductFeatureCategory = "shipping" | "seller" | "condition" | "platform" | "auction" | "preorder" | "custom";
+export type ProductFeatureProductType = "product" | "auction" | "preorder" | "all";
+/**
+ * Either an appkit icon-set name key (e.g. "truck") or a raw SVG path-d string.
+ * Path strings must start with "M " — see isFeatureIconPath().
+ */
+export type ProductFeatureIcon = string;
+export declare function isFeatureIconPath(icon: string): boolean;
+export interface ProductFeatureDocument {
+    id: string;
+    slug: string;
+    label: string;
+    description?: string;
+    /** Icon-set name key OR raw SVG path-d string (see isFeatureIconPath). */
+    icon: ProductFeatureIcon;
+    /** CSS variable token key, e.g. "--appkit-color-primary". Optional — defaults to neutral. */
+    iconColor?: string;
+    category: ProductFeatureCategory;
+    scope: ProductFeatureScope;
+    productTypes: ProductFeatureProductType[];
+    /** Required when scope === "store". */
+    storeId?: string;
+    isActive: boolean;
+    displayOrder: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export type ProductFeatureCreateInput = Omit<ProductFeatureDocument, "id" | "slug" | "createdAt" | "updatedAt">;
+export type ProductFeatureUpdateInput = Partial<Pick<ProductFeatureDocument, "label" | "description" | "icon" | "iconColor" | "category" | "productTypes" | "isActive" | "displayOrder">>;
+export declare const PRODUCT_FEATURE_SIEVE_FIELDS: {
+    readonly label: {
+        readonly canFilter: true;
+        readonly canSort: true;
+    };
+    readonly slug: {
+        readonly canFilter: true;
+        readonly canSort: false;
+    };
+    readonly scope: {
+        readonly canFilter: true;
+        readonly canSort: false;
+    };
+    readonly storeId: {
+        readonly canFilter: true;
+        readonly canSort: false;
+    };
+    readonly category: {
+        readonly canFilter: true;
+        readonly canSort: false;
+    };
+    readonly isActive: {
+        readonly canFilter: true;
+        readonly canSort: false;
+    };
+    readonly displayOrder: {
+        readonly canFilter: false;
+        readonly canSort: true;
+    };
+    readonly createdAt: {
+        readonly canFilter: false;
+        readonly canSort: true;
+    };
+};

package/dist/features/products/schemas/product-features.js

@@ -0,0 +1,33 @@
+/**
+ * Product Features — Firestore schema
+ *
+ * A productFeature is a reusable badge that products opt into via product.features[].
+ * Two scopes:
+ *   - "platform": admin-curated, available to every store
+ *   - "store":    seller-owned, scoped to one storeId, capped at MAX_STORE_CUSTOM_FEATURES
+ *
+ * id === slug, prefix "feature-".
+ *
+ * The icon field accepts either:
+ *   - a name key from the appkit icon set (e.g. "truck", "badge-check", "trophy"), or
+ *   - a raw SVG path-d string starting with "M " (rare; for store custom icons).
+ *
+ * MAX_FEATURES_PER_PRODUCT — hard cap on product.features[].length, enforced by FI5 form.
+ */
+export const PRODUCT_FEATURES_COLLECTION = "productFeatures";
+export const PRODUCT_FEATURE_PREFIX = "feature-";
+export const MAX_STORE_CUSTOM_FEATURES = 20;
+export const MAX_FEATURES_PER_PRODUCT = 10;
+export function isFeatureIconPath(icon) {
+    return icon.trimStart().startsWith("M ") || icon.trimStart().startsWith("m ");
+}
+export const PRODUCT_FEATURE_SIEVE_FIELDS = {
+    label: { canFilter: true, canSort: true },
+    slug: { canFilter: true, canSort: false },
+    scope: { canFilter: true, canSort: false },
+    storeId: { canFilter: true, canSort: false },
+    category: { canFilter: true, canSort: false },
+    isActive: { canFilter: true, canSort: false },
+    displayOrder: { canFilter: false, canSort: true },
+    createdAt: { canFilter: false, canSort: true },
+};