@mohasinac/appkit 2.4.3 → 2.4.4

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

@@ -37,5 +37,10 @@ export type { RelatedProductsProps } from "./RelatedProducts";
 export { ProductGalleryClient } from "./ProductGalleryClient";
 export type { ProductGalleryClientProps } from "./ProductGalleryClient";
 export { ProductTabsShell } from "./ProductTabsShell";
-export type { ProductTabsShellProps } from "./ProductTabsShell";
+export type { ProductTabsShellProps, CustomTabDef } from "./ProductTabsShell";
+export { CustomFieldsEditor } from "./CustomFieldsEditor";
+export type { CustomFieldsEditorProps } from "./CustomFieldsEditor";
+export { CustomSectionsEditor } from "./CustomSectionsEditor";
+export type { CustomSectionsEditorProps } from "./CustomSectionsEditor";
+export { CustomSectionTabContent } from "./CustomSectionTabContent";
 export { RelatedProductsCarousel } from "./RelatedProductsCarousel";

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

@@ -19,4 +19,7 @@ export { MakeOfferButton } from "./MakeOfferButton";
 export { RelatedProducts } from "./RelatedProducts";
 export { ProductGalleryClient } from "./ProductGalleryClient";
 export { ProductTabsShell } from "./ProductTabsShell";
+export { CustomFieldsEditor } from "./CustomFieldsEditor";
+export { CustomSectionsEditor } from "./CustomSectionsEditor";
+export { CustomSectionTabContent } from "./CustomSectionTabContent";
 export { RelatedProductsCarousel } from "./RelatedProductsCarousel";

package/dist/features/products/repository/sublisting-categories.repository.d.ts

@@ -0,0 +1,16 @@
+import { BaseRepository, type FirebaseSieveFields, type FirebaseSieveResult, type SieveModel } from "../../../providers/db-firebase";
+import { type SublistingCategoryCreateInput, type SublistingCategoryDocument, type SublistingCategoryUpdateInput } from "../schemas/sublisting-categories";
+export declare class SublistingCategoriesRepository extends BaseRepository<SublistingCategoryDocument> {
+    static readonly SIEVE_FIELDS: FirebaseSieveFields;
+    constructor();
+    generateId(name: string): string;
+    list(model: SieveModel): Promise<FirebaseSieveResult<SublistingCategoryDocument>>;
+    findBySlug(slug: string): Promise<SublistingCategoryDocument | null>;
+    create(input: SublistingCategoryCreateInput): Promise<SublistingCategoryDocument>;
+    update(id: string, input: SublistingCategoryUpdateInput): Promise<SublistingCategoryDocument>;
+    delete(id: string): Promise<void>;
+    /** Returns products/auctions/pre-orders with matching sublistingCategoryId, ordered by price asc. */
+    getListingsByCategoryId(categoryId: string, limit?: number): Promise<Record<string, unknown>[]>;
+    incrementProductCount(id: string, delta: number): Promise<void>;
+}
+export declare const sublistingCategoriesRepository: SublistingCategoriesRepository;

package/dist/features/products/repository/sublisting-categories.repository.js

@@ -0,0 +1,126 @@
+import { DatabaseError } from "../../../errors";
+import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { SUBLISTING_CATEGORIES_COLLECTION, SUBLISTING_CATEGORY_PREFIX, } from "../schemas/sublisting-categories";
+import { PRODUCT_COLLECTION } from "../schemas/firestore";
+function slugify(name) {
+    return name
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+export class SublistingCategoriesRepository extends BaseRepository {
+    constructor() {
+        super(SUBLISTING_CATEGORIES_COLLECTION);
+    }
+    generateId(name) {
+        const base = slugify(name);
+        return base.startsWith(SUBLISTING_CATEGORY_PREFIX)
+            ? base
+            : `${SUBLISTING_CATEGORY_PREFIX}${base}`;
+    }
+    async list(model) {
+        return this.sieveQuery(model, SublistingCategoriesRepository.SIEVE_FIELDS);
+    }
+    async findBySlug(slug) {
+        try {
+            const snapshot = await this.db
+                .collection(this.collection)
+                .where("slug", "==", slug)
+                .limit(1)
+                .get();
+            if (snapshot.empty)
+                return null;
+            return this.mapDoc(snapshot.docs[0]);
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to find sublisting category by slug: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    async create(input) {
+        try {
+            const id = this.generateId(input.name);
+            const now = new Date();
+            const doc = {
+                ...input,
+                slug: id,
+                productCount: 0,
+                createdAt: now,
+                updatedAt: now,
+            };
+            await this.db
+                .collection(this.collection)
+                .doc(id)
+                .set(prepareForFirestore(doc));
+            return this.findByIdOrFail(id);
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to create sublisting category: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    async update(id, input) {
+        try {
+            await this.db
+                .collection(this.collection)
+                .doc(id)
+                .update({ ...input, updatedAt: new Date() });
+            return this.findByIdOrFail(id);
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to update sublisting category: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    async delete(id) {
+        try {
+            const batch = this.db.batch();
+            // Unlink all member products before deleting the category
+            const membersSnap = await this.db
+                .collection(PRODUCT_COLLECTION)
+                .where("sublistingCategoryId", "==", id)
+                .get();
+            for (const doc of membersSnap.docs) {
+                batch.update(doc.ref, { sublistingCategoryId: null, updatedAt: new Date() });
+            }
+            batch.delete(this.db.collection(this.collection).doc(id));
+            await batch.commit();
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to delete sublisting category: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /** Returns products/auctions/pre-orders with matching sublistingCategoryId, ordered by price asc. */
+    async getListingsByCategoryId(categoryId, limit = 20) {
+        try {
+            const snap = await this.db
+                .collection(PRODUCT_COLLECTION)
+                .where("sublistingCategoryId", "==", categoryId)
+                .where("status", "==", "published")
+                .orderBy("price", "asc")
+                .limit(limit)
+                .get();
+            return snap.docs.map((d) => ({ id: d.id, ...d.data() }));
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to get listings for category ${categoryId}: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    async incrementProductCount(id, delta) {
+        try {
+            const { increment } = await import("../../../contracts/field-ops");
+            await this.db
+                .collection(this.collection)
+                .doc(id)
+                .update({ productCount: increment(delta), updatedAt: new Date() });
+        }
+        catch {
+            // Fire-and-forget — count drift is acceptable; a nightly job can reconcile
+        }
+    }
+}
+SublistingCategoriesRepository.SIEVE_FIELDS = {
+    name: { canFilter: true, canSort: true },
+    slug: { canFilter: true, canSort: false },
+    productCount: { canFilter: false, canSort: true },
+    createdAt: { canFilter: false, canSort: true },
+};
+export const sublistingCategoriesRepository = new SublistingCategoriesRepository();

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

@@ -15,6 +15,21 @@ export interface ProductSpecification {
     value: string;
     unit?: string;
 }
+export type CustomFieldType = "text" | "number" | "boolean" | "url";
+export interface CustomField {
+    key: string;
+    type: CustomFieldType;
+    value: string;
+    unit?: string;
+}
+export declare const MAX_CUSTOM_FIELDS = 50;
+export declare const MAX_CUSTOM_SECTIONS = 3;
+export interface CustomSection {
+    id: string;
+    title: string;
+    text?: string;
+    fields?: CustomField[];
+}
 export interface ProductDocument {
     id: string;
     title: string;
@@ -84,6 +99,9 @@ export interface ProductDocument {
     howToUse?: string[];
     allowOffers?: boolean;
     minOfferPercent?: number;
+    customFields?: CustomField[];
+    customSections?: CustomSection[];
+    sublistingCategoryId?: string;
     createdAt: Date;
     updatedAt: Date;
 }
@@ -99,8 +117,8 @@ export declare const ProductStatusValues: {
 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 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", "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"];
+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", "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"];
 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

@@ -2,6 +2,8 @@
  * Products Firestore Document Types & Constants
  */
 import { generateProductId, generateAuctionId, generatePreOrderId, } from "../../../utils/id-generators";
+export const MAX_CUSTOM_FIELDS = 50;
+export const MAX_CUSTOM_SECTIONS = 3;
 /** Runtime-accessible product status values — use instead of bare string literals. */
 export const ProductStatusValues = {
     DRAFT: "draft",
@@ -94,6 +96,9 @@ export const PRODUCT_PUBLIC_FIELDS = [
     "seoDescription",
     "seoKeywords",
     "viewCount",
+    "customFields",
+    "customSections",
+    "sublistingCategoryId",
     "createdAt",
 ];
 export const PRODUCT_UPDATABLE_FIELDS = [
@@ -133,6 +138,9 @@ export const PRODUCT_UPDATABLE_FIELDS = [
     "seoTitle",
     "seoDescription",
     "seoKeywords",
+    "customFields",
+    "customSections",
+    "sublistingCategoryId",
 ];
 export const productQueryHelpers = {
     byStore: (storeId) => ["storeId", "==", storeId],

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

@@ -174,6 +174,63 @@ export declare const productItemSchema: z.ZodObject<{
     pickupAddressId: z.ZodOptional<z.ZodString>;
     insurance: z.ZodOptional<z.ZodBoolean>;
     insuranceCost: z.ZodOptional<z.ZodNumber>;
+    customFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        type: z.ZodEnum<["text", "number", "boolean", "url"]>;
+        value: z.ZodString;
+        unit: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        type: "number" | "boolean" | "text" | "url";
+        key: string;
+        unit?: string | undefined;
+    }, {
+        value: string;
+        type: "number" | "boolean" | "text" | "url";
+        key: string;
+        unit?: string | undefined;
+    }>, "many">>;
+    customSections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        text: z.ZodOptional<z.ZodString>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            type: z.ZodEnum<["text", "number", "boolean", "url"]>;
+            value: z.ZodString;
+            unit: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            type: "number" | "boolean" | "text" | "url";
+            key: string;
+            unit?: string | undefined;
+        }, {
+            value: string;
+            type: "number" | "boolean" | "text" | "url";
+            key: string;
+            unit?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        text?: string | undefined;
+        fields?: {
+            value: string;
+            type: "number" | "boolean" | "text" | "url";
+            key: string;
+            unit?: string | undefined;
+        }[] | undefined;
+    }, {
+        id: string;
+        title: string;
+        text?: string | undefined;
+        fields?: {
+            value: string;
+            type: "number" | "boolean" | "text" | "url";
+            key: string;
+            unit?: string | undefined;
+        }[] | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     title: string;
@@ -209,24 +266,13 @@ export declare const productItemSchema: z.ZodObject<{
     features?: string[] | undefined;
     featured?: boolean | undefined;
     isPromoted?: boolean | undefined;
-    originalPrice?: number | undefined;
-    mainImage?: string | undefined;
-    currentBid?: number | undefined;
-    availableQuantity?: number | undefined;
-    categorySlug?: string | undefined;
-    sellerAvatar?: string | undefined;
-    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
-    listingType?: "fixed" | "auction" | "standard" | "pre-order" | undefined;
     isAuction?: boolean | undefined;
     isPreOrder?: boolean | undefined;
-    inStock?: boolean | undefined;
-    stockCount?: number | undefined;
-    reviewCount?: number | undefined;
-    attributes?: Record<string, string> | undefined;
-    publishedAt?: string | undefined;
-    stockQuantity?: number | undefined;
     subcategory?: string | undefined;
     brand?: string | undefined;
+    stockQuantity?: number | undefined;
+    availableQuantity?: number | undefined;
+    mainImage?: string | undefined;
     specifications?: {
         value: string;
         name: string;
@@ -234,17 +280,14 @@ export declare const productItemSchema: z.ZodObject<{
     }[] | undefined;
     shippingInfo?: string | undefined;
     returnPolicy?: string | undefined;
-    ingredients?: string[] | undefined;
-    howToUse?: string[] | undefined;
-    allowOffers?: boolean | undefined;
-    minOfferPercent?: number | undefined;
-    bulkDiscounts?: {
-        quantity: number;
-        discountPercent: number;
-    }[] | undefined;
+    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
+    insurance?: boolean | undefined;
+    insuranceCost?: number | undefined;
+    shippingPaidBy?: "seller" | "buyer" | undefined;
+    auctionEndDate?: string | Date | undefined;
     startingBid?: number | undefined;
+    currentBid?: number | undefined;
     bidCount?: number | undefined;
-    auctionEndDate?: string | Date | undefined;
     reservePrice?: number | undefined;
     buyNowPrice?: number | undefined;
     minBidIncrement?: number | undefined;
@@ -258,12 +301,43 @@ export declare const productItemSchema: z.ZodObject<{
     preOrderCurrentCount?: number | undefined;
     preOrderProductionStatus?: "upcoming" | "in_production" | "ready_to_ship" | undefined;
     preOrderCancellable?: boolean | undefined;
+    pickupAddressId?: string | undefined;
     viewCount?: number | undefined;
     avgRating?: number | undefined;
-    shippingPaidBy?: "seller" | "buyer" | undefined;
-    pickupAddressId?: string | undefined;
-    insurance?: boolean | undefined;
-    insuranceCost?: number | undefined;
+    reviewCount?: number | undefined;
+    bulkDiscounts?: {
+        quantity: number;
+        discountPercent: number;
+    }[] | undefined;
+    ingredients?: string[] | undefined;
+    howToUse?: string[] | undefined;
+    allowOffers?: boolean | undefined;
+    minOfferPercent?: number | undefined;
+    customFields?: {
+        value: string;
+        type: "number" | "boolean" | "text" | "url";
+        key: string;
+        unit?: string | undefined;
+    }[] | undefined;
+    customSections?: {
+        id: string;
+        title: string;
+        text?: string | undefined;
+        fields?: {
+            value: string;
+            type: "number" | "boolean" | "text" | "url";
+            key: string;
+            unit?: string | undefined;
+        }[] | undefined;
+    }[] | 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;
+    publishedAt?: string | undefined;
 }, {
     id: string;
     title: string;
@@ -299,24 +373,13 @@ export declare const productItemSchema: z.ZodObject<{
     features?: string[] | undefined;
     featured?: boolean | undefined;
     isPromoted?: boolean | undefined;
-    originalPrice?: number | undefined;
-    mainImage?: string | undefined;
-    currentBid?: number | undefined;
-    availableQuantity?: number | undefined;
-    categorySlug?: string | undefined;
-    sellerAvatar?: string | undefined;
-    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
-    listingType?: "fixed" | "auction" | "standard" | "pre-order" | undefined;
     isAuction?: boolean | undefined;
     isPreOrder?: boolean | undefined;
-    inStock?: boolean | undefined;
-    stockCount?: number | undefined;
-    reviewCount?: number | undefined;
-    attributes?: Record<string, string> | undefined;
-    publishedAt?: string | undefined;
-    stockQuantity?: number | undefined;
     subcategory?: string | undefined;
     brand?: string | undefined;
+    stockQuantity?: number | undefined;
+    availableQuantity?: number | undefined;
+    mainImage?: string | undefined;
     specifications?: {
         value: string;
         name: string;
@@ -324,17 +387,14 @@ export declare const productItemSchema: z.ZodObject<{
     }[] | undefined;
     shippingInfo?: string | undefined;
     returnPolicy?: string | undefined;
-    ingredients?: string[] | undefined;
-    howToUse?: string[] | undefined;
-    allowOffers?: boolean | undefined;
-    minOfferPercent?: number | undefined;
-    bulkDiscounts?: {
-        quantity: number;
-        discountPercent: number;
-    }[] | undefined;
+    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
+    insurance?: boolean | undefined;
+    insuranceCost?: number | undefined;
+    shippingPaidBy?: "seller" | "buyer" | undefined;
+    auctionEndDate?: string | Date | undefined;
     startingBid?: number | undefined;
+    currentBid?: number | undefined;
     bidCount?: number | undefined;
-    auctionEndDate?: string | Date | undefined;
     reservePrice?: number | undefined;
     buyNowPrice?: number | undefined;
     minBidIncrement?: number | undefined;
@@ -348,12 +408,43 @@ export declare const productItemSchema: z.ZodObject<{
     preOrderCurrentCount?: number | undefined;
     preOrderProductionStatus?: "upcoming" | "in_production" | "ready_to_ship" | undefined;
     preOrderCancellable?: boolean | undefined;
+    pickupAddressId?: string | undefined;
     viewCount?: number | undefined;
     avgRating?: number | undefined;
-    shippingPaidBy?: "seller" | "buyer" | undefined;
-    pickupAddressId?: string | undefined;
-    insurance?: boolean | undefined;
-    insuranceCost?: number | undefined;
+    reviewCount?: number | undefined;
+    bulkDiscounts?: {
+        quantity: number;
+        discountPercent: number;
+    }[] | undefined;
+    ingredients?: string[] | undefined;
+    howToUse?: string[] | undefined;
+    allowOffers?: boolean | undefined;
+    minOfferPercent?: number | undefined;
+    customFields?: {
+        value: string;
+        type: "number" | "boolean" | "text" | "url";
+        key: string;
+        unit?: string | undefined;
+    }[] | undefined;
+    customSections?: {
+        id: string;
+        title: string;
+        text?: string | undefined;
+        fields?: {
+            value: string;
+            type: "number" | "boolean" | "text" | "url";
+            key: string;
+            unit?: string | undefined;
+        }[] | undefined;
+    }[] | 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;
+    publishedAt?: string | undefined;
 }>;
 /** Base Zod schema for list-query parameters. */
 export declare const productListParamsSchema: z.ZodObject<{
@@ -381,8 +472,8 @@ export declare const productListParamsSchema: z.ZodObject<{
     perPage?: number | undefined;
     storeId?: string | undefined;
     featured?: boolean | undefined;
-    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
     isAuction?: boolean | undefined;
+    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
     inStock?: boolean | undefined;
 }, {
     sort?: string | undefined;
@@ -395,7 +486,7 @@ export declare const productListParamsSchema: z.ZodObject<{
     perPage?: number | undefined;
     storeId?: string | undefined;
     featured?: boolean | undefined;
-    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | 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

@@ -131,6 +131,30 @@ export const productItemSchema = z.object({
     pickupAddressId: z.string().optional(),
     insurance: z.boolean().optional(),
     insuranceCost: z.number().optional(),
+    // Custom fields & sections
+    customFields: z
+        .array(z.object({
+        key: z.string(),
+        type: z.enum(["text", "number", "boolean", "url"]),
+        value: z.string(),
+        unit: z.string().optional(),
+    }))
+        .optional(),
+    customSections: z
+        .array(z.object({
+        id: z.string(),
+        title: z.string(),
+        text: z.string().optional(),
+        fields: z
+            .array(z.object({
+            key: z.string(),
+            type: z.enum(["text", "number", "boolean", "url"]),
+            value: z.string(),
+            unit: z.string().optional(),
+        }))
+            .optional(),
+    }))
+        .optional(),
 });
 /** Base Zod schema for list-query parameters. */
 export const productListParamsSchema = z.object({

package/dist/features/products/schemas/sublisting-categories.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Sub-listing Categories — Firestore schema
+ *
+ * A sub-listing category is a named bucket that groups independent listings of the
+ * same real-world collectible across conditions, grades, prices, and sellers.
+ * Each listing stays a full product/auction/pre-order — the category is just the
+ * thread linking them (e.g. "Base Set Charizard 108/120").
+ */
+export declare const SUBLISTING_CATEGORIES_COLLECTION: "sublistingCategories";
+export declare const SUBLISTING_CATEGORY_PREFIX: "sublisting-";
+export interface SublistingCategoryDocument {
+    id: string;
+    slug: string;
+    name: string;
+    /** Card set code or grade label, e.g. "108/120", "PSA 10" */
+    itemCode?: string;
+    description?: string;
+    /** /media/<slug> proxy URL */
+    coverImage?: string;
+    /** Denormalised count — updated on member add/remove */
+    productCount: number;
+    createdAt: Date;
+    updatedAt: Date;
+    createdBy: string;
+}
+export type SublistingCategoryCreateInput = Omit<SublistingCategoryDocument, "id" | "productCount" | "createdAt" | "updatedAt">;
+export type SublistingCategoryUpdateInput = Partial<Pick<SublistingCategoryDocument, "name" | "itemCode" | "description" | "coverImage">>;
+export declare const SUBLISTING_CATEGORY_SIEVE_FIELDS: {
+    readonly name: {
+        readonly canFilter: true;
+        readonly canSort: true;
+    };
+    readonly slug: {
+        readonly canFilter: true;
+        readonly canSort: false;
+    };
+    readonly productCount: {
+        readonly canFilter: false;
+        readonly canSort: true;
+    };
+    readonly createdAt: {
+        readonly canFilter: false;
+        readonly canSort: true;
+    };
+};

package/dist/features/products/schemas/sublisting-categories.js

@@ -0,0 +1,16 @@
+/**
+ * Sub-listing Categories — Firestore schema
+ *
+ * A sub-listing category is a named bucket that groups independent listings of the
+ * same real-world collectible across conditions, grades, prices, and sellers.
+ * Each listing stays a full product/auction/pre-order — the category is just the
+ * thread linking them (e.g. "Base Set Charizard 108/120").
+ */
+export const SUBLISTING_CATEGORIES_COLLECTION = "sublistingCategories";
+export const SUBLISTING_CATEGORY_PREFIX = "sublisting-";
+export const SUBLISTING_CATEGORY_SIEVE_FIELDS = {
+    name: { canFilter: true, canSort: true },
+    slug: { canFilter: true, canSort: false },
+    productCount: { canFilter: false, canSort: true },
+    createdAt: { canFilter: false, canSort: true },
+};

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

@@ -1,4 +1,6 @@
 import type { MediaField } from "../../media/types/index";
+import type { CustomField, CustomSection } from "../schemas/firestore";
+export type { CustomField, CustomSection } from "../schemas/firestore";
 export type ProductStatus = "draft" | "published" | "archived" | "sold" | "out_of_stock" | "discontinued";
 export type ProductCondition = "new" | "like_new" | "good" | "fair" | "poor" | "used" | "refurbished" | "broken";
 export type ListingType = "fixed" | "standard" | "auction" | "pre-order";
@@ -103,6 +105,8 @@ export interface ProductItem {
     pickupAddressId?: string;
     insurance?: boolean;
     insuranceCost?: number;
+    customFields?: CustomField[];
+    customSections?: CustomSection[];
 }
 export interface ProductListResponse {
     items: ProductItem[];

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

@@ -29,8 +29,8 @@ export declare const searchProductItemSchema: z.ZodObject<{
     currency?: string | undefined;
     featured?: boolean | undefined;
     isPromoted?: boolean | undefined;
-    mainImage?: string | undefined;
     isAuction?: boolean | undefined;
+    mainImage?: string | undefined;
 }, {
     id: string;
     title: string;
@@ -40,8 +40,8 @@ export declare const searchProductItemSchema: z.ZodObject<{
     currency?: string | undefined;
     featured?: boolean | undefined;
     isPromoted?: boolean | undefined;
-    mainImage?: string | undefined;
     isAuction?: boolean | undefined;
+    mainImage?: string | undefined;
 }>;
 /**
  * Form/query schema for a search request.