@mohasinac/appkit 2.6.1 → 2.6.3

package/dist/features/products/repository/products.repository.js

@@ -10,11 +10,9 @@ const PRODUCT_FIELDS = {
     FEATURED: "featured",
     CATEGORY: "category",
     SLUG: "slug",
-    // SB1-G (S21 2026-05-12) — canonical discriminator. Boolean flags below kept
-    // as deprecated aliases for any consumer code that hasn't migrated yet.
+    // SB1-G (S3 2026-05-13) — canonical discriminator. Legacy `isAuction` /
+    // `isPreOrder` boolean fields were removed in this session.
     LISTING_TYPE: "listingType",
-    IS_AUCTION: "isAuction",
-    IS_PRE_ORDER: "isPreOrder",
     PRE_ORDER_DELIVERY_DATE: "preOrderDeliveryDate",
     IS_PROMOTED: "isPromoted",
     AUCTION_END_DATE: "auctionEndDate",
@@ -37,16 +35,23 @@ const LISTING_TYPE_VALUES = {
 // clauses with single-field `listingType==X` clauses now that every doc
 // carries the discriminator.
 const SIEVE_CLAUSE_PUBLISHED = `${PRODUCT_FIELDS.STATUS}==${ProductStatusValues.PUBLISHED}`;
-const SIEVE_CLAUSE_IS_AUCTION = `${PRODUCT_FIELDS.LISTING_TYPE}==${LISTING_TYPE_VALUES.AUCTION}`;
-const SIEVE_CLAUSE_IS_PREORDER = `${PRODUCT_FIELDS.LISTING_TYPE}==${LISTING_TYPE_VALUES.PRE_ORDER}`;
-const SIEVE_CLAUSE_IS_STANDARD = `${PRODUCT_FIELDS.LISTING_TYPE}==${LISTING_TYPE_VALUES.STANDARD}`;
+const SIEVE_CLAUSE_LT_AUCTION = `${PRODUCT_FIELDS.LISTING_TYPE}==${LISTING_TYPE_VALUES.AUCTION}`;
+const SIEVE_CLAUSE_LT_PREORDER = `${PRODUCT_FIELDS.LISTING_TYPE}==${LISTING_TYPE_VALUES.PRE_ORDER}`;
+const SIEVE_CLAUSE_LT_STANDARD = `${PRODUCT_FIELDS.LISTING_TYPE}==${LISTING_TYPE_VALUES.STANDARD}`;
+const SIEVE_CLAUSE_LT_PRIZE_DRAW = `${PRODUCT_FIELDS.LISTING_TYPE}==${LISTING_TYPE_VALUES.PRIZE_DRAW}`;
+const LISTING_KIND_ALIAS_MAP = {
+    standard: LISTING_TYPE_VALUES.STANDARD,
+    auction: LISTING_TYPE_VALUES.AUCTION,
+    "pre-order": LISTING_TYPE_VALUES.PRE_ORDER,
+    "prize-draw": LISTING_TYPE_VALUES.PRIZE_DRAW,
+    // Legacy → canonical.
+    product: LISTING_TYPE_VALUES.STANDARD,
+    preorder: LISTING_TYPE_VALUES.PRE_ORDER,
+    prizedraw: LISTING_TYPE_VALUES.PRIZE_DRAW,
+};
+const LISTING_KIND_ACCEPTED = new Set(Object.keys(LISTING_KIND_ALIAS_MAP));
 function buildListingKindClause(kind, inverted) {
-    // Map the public alias tokens to canonical Firestore values.
-    const canonical = kind === "auction"
-        ? LISTING_TYPE_VALUES.AUCTION
-        : kind === "preorder"
-            ? LISTING_TYPE_VALUES.PRE_ORDER
-            : LISTING_TYPE_VALUES.STANDARD;
+    const canonical = LISTING_KIND_ALIAS_MAP[kind];
     const op = inverted ? "!=" : "==";
     return `${PRODUCT_FIELDS.LISTING_TYPE}${op}${canonical}`;
 }
@@ -399,6 +404,21 @@ export class ProductRepository extends BaseRepository {
             updatedAt: serverTimestamp(),
         });
     }
+    /**
+     * SB6-C / SB4-H — atomically bump `prizeCurrentEntries` by `count`. The
+     * checkout transaction calls this after pool-cap validation; the reveal
+     * code-path uses it as a defence-in-depth check (already incremented at
+     * order create, so this is a no-op unless we shift accounting later).
+     */
+    incrementPrizeEntriesInBatch(batch, productId, count) {
+        batch.update(this.db.collection(this.collection).doc(productId), {
+            prizeCurrentEntries: increment(count),
+            updatedAt: serverTimestamp(),
+        });
+    }
+    productRef(productId) {
+        return this.db.collection(this.collection).doc(productId);
+    }
 }
 ProductRepository.CACHE_TTL_MS = 30000;
 ProductRepository.SIEVE_FIELDS = {
@@ -413,8 +433,7 @@ ProductRepository.SIEVE_FIELDS = {
     storeId: { canFilter: true, canSort: false },
     storeName: { canFilter: true, canSort: true },
     featured: { canFilter: true, canSort: false },
-    isAuction: { canFilter: true, canSort: false },
-    isPreOrder: { canFilter: true, canSort: false },
+    listingType: { canFilter: true, canSort: false },
     isPromoted: { canFilter: true, canSort: false },
     price: { canFilter: true, canSort: true },
     stockQuantity: { canFilter: true, canSort: true },
@@ -443,8 +462,8 @@ ProductRepository.SIEVE_FIELDS = {
     freeShipping: { canFilter: true, canSort: false },
 };
 /**
- * Virtual filter aliases — callers can pass `f=listingType==auction` instead
- * of `f=isAuction==true,isPreOrder==false`. The Sieve adapter expands the
+ * Virtual filter aliases — callers can pass `f=listingType==auction` for
+ * the canonical listing-kind discriminator. The Sieve adapter expands the
  * alias into real clauses before reaching Firestore.
  *
  * Adding a new alias here makes it usable everywhere `productRepository.list`
@@ -466,7 +485,11 @@ ProductRepository.FILTER_ALIASES = {
     listingType: (value, operator) => {
         if (operator !== "==" && operator !== "!=")
             return "";
-        if (value !== "auction" && value !== "preorder" && value !== "product")
+        // Accept both canonical tokens (`standard`, `auction`, `pre-order`,
+        // `prize-draw`) and legacy aliases (`product`, `preorder`, `prizedraw`).
+        // `LISTING_KIND_ACCEPTED` is the single source of truth — keep it in
+        // sync with `LISTING_KIND_ALIAS_MAP`.
+        if (!LISTING_KIND_ACCEPTED.has(value))
             return "";
         return buildListingKindClause(value, operator === "!=");
     },
@@ -474,9 +497,9 @@ ProductRepository.FILTER_ALIASES = {
      * Public catalog scope shorthand. Maps a single token to the canonical
      * combination most public pages use.
      *
-     *   scope==publicProducts   →  status==published,isAuction==false,isPreOrder==false
-     *   scope==publicAuctions   →  status==published,isAuction==true
-     *   scope==publicPreorders  →  status==published,isPreOrder==true
+     *   scope==publicProducts   →  status==published,listingType==standard
+     *   scope==publicAuctions   →  status==published,listingType==auction
+     *   scope==publicPreorders  →  status==published,listingType==pre-order
      *   scope==published        →  status==published
      */
     scope: (value, operator) => {
@@ -484,11 +507,13 @@ ProductRepository.FILTER_ALIASES = {
             return "";
         switch (value) {
             case "publicProducts":
-                return [SIEVE_CLAUSE_PUBLISHED, SIEVE_CLAUSE_IS_STANDARD].join(",");
+                return [SIEVE_CLAUSE_PUBLISHED, SIEVE_CLAUSE_LT_STANDARD].join(",");
             case "publicAuctions":
-                return [SIEVE_CLAUSE_PUBLISHED, SIEVE_CLAUSE_IS_AUCTION].join(",");
+                return [SIEVE_CLAUSE_PUBLISHED, SIEVE_CLAUSE_LT_AUCTION].join(",");
             case "publicPreorders":
-                return [SIEVE_CLAUSE_PUBLISHED, SIEVE_CLAUSE_IS_PREORDER].join(",");
+                return [SIEVE_CLAUSE_PUBLISHED, SIEVE_CLAUSE_LT_PREORDER].join(",");
+            case "publicPrizeDraws":
+                return [SIEVE_CLAUSE_PUBLISHED, SIEVE_CLAUSE_LT_PRIZE_DRAW].join(",");
             case "published":
                 return SIEVE_CLAUSE_PUBLISHED;
             default:

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

@@ -111,7 +111,7 @@ export interface ProductDocument {
      * `where("listingType", "==", X)` against the `listingType+...` composite
      * indexes in `appkit/firebase/base/firestore.indexes.json`.
      */
-    listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
+    listingType: "standard" | "auction" | "pre-order" | "prize-draw";
     /** Hard cap on units a single user may purchase (SB1-B; bundle/prize-draw). */
     maxPerUser?: number;
     /** Reverse pointers — bundle ids that include this product. */
@@ -172,8 +172,8 @@ export declare const productQueryHelpers: {
     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 auctions: () => readonly ["listingType", "==", "auction"];
+    readonly preOrders: () => readonly ["listingType", "==", "pre-order"];
     readonly promoted: () => readonly ["isPromoted", "==", true];
     readonly activeAuction: (date: Date) => readonly ["auctionEndDate", ">=", Date];
 };

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

@@ -158,8 +158,8 @@ export const productQueryHelpers = {
     featured: () => ["featured", "==", true],
     published: () => ["status", "==", "published"],
     available: () => ["availableQuantity", ">", 0],
-    auctions: () => ["isAuction", "==", true],
-    preOrders: () => ["isPreOrder", "==", true],
+    auctions: () => ["listingType", "==", "auction"],
+    preOrders: () => ["listingType", "==", "pre-order"],
     promoted: () => ["isPromoted", "==", true],
     activeAuction: (date) => ["auctionEndDate", ">=", date],
 };

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

@@ -309,7 +309,7 @@ export declare const productItemSchema: z.ZodObject<{
     rating?: number | undefined;
     description?: string | undefined;
     featured?: boolean | undefined;
-    listingType?: "auction" | "standard" | "pre-order" | "prize-draw" | "bundle" | undefined;
+    listingType?: "auction" | "standard" | "prize-draw" | "pre-order" | "bundle" | undefined;
     isPromoted?: boolean | undefined;
     slug?: string | undefined;
     subcategory?: string | undefined;
@@ -438,7 +438,7 @@ export declare const productItemSchema: z.ZodObject<{
     rating?: number | undefined;
     description?: string | undefined;
     featured?: boolean | undefined;
-    listingType?: "auction" | "standard" | "pre-order" | "prize-draw" | "bundle" | undefined;
+    listingType?: "auction" | "standard" | "prize-draw" | "pre-order" | "bundle" | undefined;
     isPromoted?: boolean | undefined;
     slug?: string | undefined;
     subcategory?: string | undefined;
@@ -551,7 +551,7 @@ export declare const productListParamsSchema: z.ZodObject<{
     minPrice: z.ZodOptional<z.ZodNumber>;
     maxPrice: z.ZodOptional<z.ZodNumber>;
     inStock: z.ZodOptional<z.ZodBoolean>;
-    isAuction: z.ZodOptional<z.ZodBoolean>;
+    listingType: z.ZodOptional<z.ZodEnum<["standard", "auction", "pre-order", "prize-draw", "bundle"]>>;
     storeId: z.ZodOptional<z.ZodString>;
     sort: z.ZodOptional<z.ZodString>;
     page: z.ZodOptional<z.ZodNumber>;
@@ -568,8 +568,8 @@ export declare const productListParamsSchema: z.ZodObject<{
     minPrice?: number | undefined;
     maxPrice?: number | undefined;
     featured?: boolean | undefined;
+    listingType?: "auction" | "standard" | "prize-draw" | "pre-order" | "bundle" | undefined;
     condition?: "new" | "used" | "refurbished" | "fair" | "good" | "like_new" | "poor" | "broken" | undefined;
-    isAuction?: boolean | undefined;
     inStock?: boolean | undefined;
 }, {
     sort?: string | undefined;
@@ -582,7 +582,7 @@ export declare const productListParamsSchema: z.ZodObject<{
     minPrice?: number | undefined;
     maxPrice?: number | undefined;
     featured?: boolean | undefined;
+    listingType?: "auction" | "standard" | "prize-draw" | "pre-order" | "bundle" | undefined;
     condition?: "new" | "used" | "refurbished" | "fair" | "good" | "like_new" | "poor" | "broken" | undefined;
-    isAuction?: boolean | undefined;
     inStock?: boolean | undefined;
 }>;

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

@@ -214,7 +214,9 @@ export const productListParamsSchema = z.object({
     minPrice: z.coerce.number().optional(),
     maxPrice: z.coerce.number().optional(),
     inStock: z.coerce.boolean().optional(),
-    isAuction: z.coerce.boolean().optional(),
+    listingType: z
+        .enum(["standard", "auction", "pre-order", "prize-draw", "bundle"])
+        .optional(),
     storeId: z.string().optional(),
     sort: z.string().optional(),
     page: z.coerce.number().optional(),

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

@@ -27,8 +27,8 @@ export declare const productFeatureAdminCreateSchema: z.ZodObject<{
     icon: string;
     isActive: boolean;
     category: "seller" | "auction" | "preorder" | "shipping" | "custom" | "condition" | "platform";
-    displayOrder: number;
     productTypes: ("all" | "product" | "auction" | "preorder")[];
+    displayOrder: number;
     storeId?: string | undefined;
     description?: string | undefined;
     iconColor?: string | undefined;
@@ -38,8 +38,8 @@ export declare const productFeatureAdminCreateSchema: z.ZodObject<{
     icon: string;
     isActive: boolean;
     category: "seller" | "auction" | "preorder" | "shipping" | "custom" | "condition" | "platform";
-    displayOrder: number;
     productTypes: ("all" | "product" | "auction" | "preorder")[];
+    displayOrder: number;
     storeId?: string | undefined;
     description?: string | undefined;
     iconColor?: string | undefined;
@@ -59,8 +59,8 @@ export declare const productFeatureStoreCreateSchema: z.ZodObject<{
     icon: string;
     isActive: boolean;
     category: "seller" | "auction" | "preorder" | "shipping" | "custom" | "condition" | "platform";
-    displayOrder: number;
     productTypes: ("all" | "product" | "auction" | "preorder")[];
+    displayOrder: number;
     description?: string | undefined;
     iconColor?: string | undefined;
 }, {
@@ -68,8 +68,8 @@ export declare const productFeatureStoreCreateSchema: z.ZodObject<{
     icon: string;
     isActive: boolean;
     category: "seller" | "auction" | "preorder" | "shipping" | "custom" | "condition" | "platform";
-    displayOrder: number;
     productTypes: ("all" | "product" | "auction" | "preorder")[];
+    displayOrder: number;
     description?: string | undefined;
     iconColor?: string | undefined;
 }>;
@@ -90,8 +90,8 @@ export declare const productFeatureUpdateSchema: z.ZodObject<{
     category?: "seller" | "auction" | "preorder" | "shipping" | "custom" | "condition" | "platform" | undefined;
     description?: string | undefined;
     iconColor?: string | undefined;
-    displayOrder?: number | undefined;
     productTypes?: ("all" | "product" | "auction" | "preorder")[] | undefined;
+    displayOrder?: number | undefined;
 }, {
     label?: string | undefined;
     icon?: string | undefined;
@@ -99,8 +99,8 @@ export declare const productFeatureUpdateSchema: z.ZodObject<{
     category?: "seller" | "auction" | "preorder" | "shipping" | "custom" | "condition" | "platform" | undefined;
     description?: string | undefined;
     iconColor?: string | undefined;
-    displayOrder?: number | undefined;
     productTypes?: ("all" | "product" | "auction" | "preorder")[] | undefined;
+    displayOrder?: number | undefined;
 }>;
 export type ProductFeatureAdminCreatePayload = z.infer<typeof productFeatureAdminCreateSchema>;
 export type ProductFeatureStoreCreatePayload = z.infer<typeof productFeatureStoreCreateSchema>;

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

@@ -10,7 +10,7 @@ export type ProductCondition = "new" | "like_new" | "good" | "fair" | "poor" | "
  * accepts legacy alias tokens (`preorder` → `pre-order`, `product` → `standard`)
  * but stored values are always one of these five.
  */
-export type ListingType = "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
+export type ListingType = "standard" | "auction" | "pre-order" | "prize-draw";
 export interface ProductImage {
     url: string;
     thumbnailUrl?: string;
@@ -49,6 +49,12 @@ export interface ProductItem {
     condition?: ProductCondition;
     /** Canonical listing-kind discriminator (SB1-G Phase 4 — booleans removed). */
     listingType?: ListingType;
+    /** Reverse refs maintained by the bundles repository (SB3) — IDs of every
+     * bundle whose `bundleItems[]` includes this product. Powers the "In bundle"
+     * badge on cards (SB7-A) + detail pages (SB7-B). */
+    partOfBundleIds?: string[];
+    /** Parallel array of titles — same length + index as `partOfBundleIds`. */
+    partOfBundleTitles?: string[];
     sublistingCategoryId?: string;
     groupId?: string;
     isGroupParent?: boolean;
@@ -109,6 +115,16 @@ export interface ProductItem {
     preOrderCurrentCount?: number;
     preOrderProductionStatus?: "upcoming" | "in_production" | "ready_to_ship";
     preOrderCancellable?: boolean;
+    prizeDrawItems?: import("../schemas/firestore").PrizeDrawItem[];
+    pricePerEntry?: number;
+    prizeMaxEntries?: number;
+    prizeCurrentEntries?: number;
+    prizeRevealWindowStart?: string | Date;
+    prizeRevealWindowEnd?: string | Date;
+    prizeRevealStatus?: "pending" | "open" | "closed";
+    prizeRevealDeadlineDays?: number;
+    prizeGithubFileUrl?: string;
+    maxPerUser?: number;
     /** Winner's display name for ended auctions — shown masked in public UI */
     winnerDisplayName?: string;
     viewCount?: number;

package/dist/features/products/utils/listing-type.d.ts

@@ -1,9 +1,9 @@
 import type { ListingType } from "../types/index";
 /**
- * Canonical accessor for the listing-kind discriminator. SB1-G Phase 4
- * (S22 2026-05-12) made `listingType` the single source of truth on every
- * `ProductDocument` / `ProductItem` — the legacy `isAuction` / `isPreOrder`
- * booleans were removed in the same session.
+ * Canonical accessor for the listing-kind discriminator. `listingType` is the
+ * single source of truth on every `ProductDocument` / `ProductItem` — the
+ * legacy `isAuction` / `isPreOrder` booleans were removed in S3 (SB1-G final,
+ * 2026-05-13).
  *
  * Returns `"standard"` when the input is undefined or missing the field, so
  * legacy payloads still classify safely without a separate guard.
@@ -21,3 +21,6 @@ export declare const isPreOrderListing: (input?: {
 export declare const isStandardListing: (input?: {
     listingType?: ListingType;
 }) => boolean;
+export declare const isPrizeDrawListing: (input?: {
+    listingType?: ListingType;
+}) => boolean;

package/dist/features/products/utils/listing-type.js

@@ -1,8 +1,8 @@
 /**
- * Canonical accessor for the listing-kind discriminator. SB1-G Phase 4
- * (S22 2026-05-12) made `listingType` the single source of truth on every
- * `ProductDocument` / `ProductItem` — the legacy `isAuction` / `isPreOrder`
- * booleans were removed in the same session.
+ * Canonical accessor for the listing-kind discriminator. `listingType` is the
+ * single source of truth on every `ProductDocument` / `ProductItem` — the
+ * legacy `isAuction` / `isPreOrder` booleans were removed in S3 (SB1-G final,
+ * 2026-05-13).
  *
  * Returns `"standard"` when the input is undefined or missing the field, so
  * legacy payloads still classify safely without a separate guard.
@@ -14,3 +14,7 @@ export function normalizeListingType(input) {
 export const isAuctionListing = (input) => normalizeListingType(input) === "auction";
 export const isPreOrderListing = (input) => normalizeListingType(input) === "pre-order";
 export const isStandardListing = (input) => normalizeListingType(input) === "standard";
+export const isPrizeDrawListing = (input) => normalizeListingType(input) === "prize-draw";
+// SB-UNI-D — isBundleListing removed. Bundles are now a categoryType
+// discriminator on CategoryDocument; consumers should query
+// `categoriesRepository.findBySlugAndType(slug, "bundle")` instead.

package/dist/features/promotions/actions/coupon-actions.d.ts

@@ -22,7 +22,7 @@ export type CouponCartItem = {
     price: number;
     quantity: number;
     /** Canonical listing-kind snapshot (SB1-G Phase 4). */
-    listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
+    listingType: "standard" | "auction" | "pre-order" | "prize-draw";
 };
 export declare function validateCoupon(userId: string, code: string, orderTotal: number): Promise<CouponValidationResult>;
 export declare function validateCouponForCart(userId: string, code: string, cartItems: CouponCartItem[]): Promise<CouponCartValidationResult>;

package/dist/features/promotions/hooks/useCouponValidate.d.ts

@@ -7,7 +7,7 @@ interface ValidateCouponPayload {
         price: number;
         quantity: number;
         /** Canonical listing-kind snapshot (SB1-G Phase 4). */
-        listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
+        listingType?: "standard" | "auction" | "pre-order" | "prize-draw";
     }>;
 }
 interface ValidateCouponResult {

package/dist/features/promotions/migrations.d.ts

@@ -0,0 +1,2 @@
+import type { MigrationStep } from "../../_internal/shared/schema-versions";
+export declare const migrations: Record<number, MigrationStep<any>>;

package/dist/features/promotions/migrations.js

@@ -0,0 +1,10 @@
+// SB-UNI X3 — migrations shell for coupon/couponUsage.
+// v1 schema is current; no migrations needed yet.
+//
+// To add a migration:
+//   1. Bump the relevant SCHEMA_VERSIONS entry in
+//      `_internal/shared/schema-versions.ts` (e.g. `promotions: 2`)
+//   2. Add a row below keyed by the FROM-version, returning the upgraded doc
+//   3. Repository wraps reads with `migrateDocument(doc, current, migrations)`
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const migrations = {};

package/dist/features/promotions/repository/coupons.repository.d.ts

@@ -140,7 +140,7 @@ export declare class CouponsRepository extends BaseRepository<CouponDocument> {
         price: number;
         quantity: number;
         /** Canonical listing-kind snapshot (SB1-G Phase 4). */
-        listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
+        listingType: "standard" | "auction" | "pre-order" | "prize-draw";
     }>): Promise<{
         valid: boolean;
         coupon?: CouponDocument;

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

@@ -47,8 +47,8 @@ export declare const couponItemSchema: z.ZodObject<{
     scope: "admin" | "seller";
     name: string;
     isActive: boolean;
-    description: string;
     isPublic: boolean;
+    description: string;
     discountValue: number;
     usageCount: number;
     storeId?: string | undefined;
@@ -71,8 +71,8 @@ export declare const couponItemSchema: z.ZodObject<{
     scope: "admin" | "seller";
     name: string;
     isActive: boolean;
-    description: string;
     isPublic: boolean;
+    description: string;
     discountValue: number;
     usageCount: number;
     storeId?: string | undefined;

package/dist/features/reviews/migrations.d.ts

@@ -0,0 +1,2 @@
+import type { MigrationStep } from "../../_internal/shared/schema-versions";
+export declare const migrations: Record<number, MigrationStep<any>>;

package/dist/features/reviews/migrations.js

@@ -0,0 +1,10 @@
+// SB-UNI X3 — migrations shell for review.
+// v1 schema is current; no migrations needed yet.
+//
+// To add a migration:
+//   1. Bump the relevant SCHEMA_VERSIONS entry in
+//      `_internal/shared/schema-versions.ts` (e.g. `reviews: 2`)
+//   2. Add a row below keyed by the FROM-version, returning the upgraded doc
+//   3. Repository wraps reads with `migrateDocument(doc, current, migrations)`
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const migrations = {};

package/dist/features/scams/migrations.d.ts

@@ -0,0 +1,2 @@
+import type { MigrationStep } from "../../_internal/shared/schema-versions";
+export declare const migrations: Record<number, MigrationStep<any>>;

package/dist/features/scams/migrations.js

@@ -0,0 +1,10 @@
+// SB-UNI X3 — migrations shell for scammer/incident/comment/contest.
+// v1 schema is current; no migrations needed yet.
+//
+// To add a migration:
+//   1. Bump the relevant SCHEMA_VERSIONS entry in
+//      `_internal/shared/schema-versions.ts` (e.g. `scams: 2`)
+//   2. Add a row below keyed by the FROM-version, returning the upgraded doc
+//   3. Repository wraps reads with `migrateDocument(doc, current, migrations)`
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const migrations = {};

package/dist/features/search/api/route.d.ts

@@ -9,7 +9,7 @@
  *
  * Performs Sieve-based product search via SearchRepository.
  * Supports: q, category, subcategory, minPrice, maxPrice, condition,
- *   isAuction, isPreOrder, inStock, minRating, sort, page, pageSize.
+ *   listingType, inStock, minRating, sort, page, pageSize.
  *
  * Note: external search providers are not built into this route. To enable one,
  * register an ISearchProvider via registerProviders() and handle it at

package/dist/features/search/api/route.js

@@ -9,7 +9,7 @@
  *
  * Performs Sieve-based product search via SearchRepository.
  * Supports: q, category, subcategory, minPrice, maxPrice, condition,
- *   isAuction, isPreOrder, inStock, minRating, sort, page, pageSize.
+ *   listingType, inStock, minRating, sort, page, pageSize.
  *
  * Note: external search providers are not built into this route. To enable one,
  * register an ISearchProvider via registerProviders() and handle it at
@@ -37,14 +37,14 @@ export async function GET(request) {
         if (!db) {
             return NextResponse.json({ success: false, error: "Database provider not registered" }, { status: 503 });
         }
-        // SB1-G Phase 4 — canonical `?listingType=auction|pre-order|standard|prize-draw|bundle`.
+        // SB1-G Phase 4 — canonical `?listingType=auction|pre-order|standard|prize-draw`.
+        // SB-UNI-D — "bundle" removed; bundles are a categoryType, not a listingType.
         const listingTypeRaw = param(url, "listingType");
         const VALID_LISTING_TYPES = new Set([
             "standard",
             "auction",
             "pre-order",
             "prize-draw",
-            "bundle",
         ]);
         const listingType = listingTypeRaw && VALID_LISTING_TYPES.has(listingTypeRaw)
             ? listingTypeRaw

package/dist/features/search/components/Search.d.ts

@@ -1,6 +1,6 @@
 import type { LucideIcon } from "lucide-react";
 import type { NavSuggestionRecord } from "../hooks/useNavSuggestions";
-export type SearchResourceType = "products" | "auctions" | "pre-orders" | "stores" | "categories" | "brands" | "events" | "blog" | "faqs";
+export type SearchResourceType = "products" | "auctions" | "pre-orders" | "prize-draws" | "bundles" | "stores" | "categories" | "brands" | "events" | "blog" | "faqs";
 export interface SearchResourceTypeOption {
     value: SearchResourceType;
     label: string;

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

@@ -17,7 +17,7 @@ export declare const searchProductItemSchema: z.ZodObject<{
     mainImage: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodString>;
     featured: z.ZodOptional<z.ZodBoolean>;
-    isAuction: z.ZodOptional<z.ZodBoolean>;
+    listingType: z.ZodOptional<z.ZodEnum<["standard", "auction", "pre-order", "prize-draw", "bundle"]>>;
     isPromoted: z.ZodOptional<z.ZodBoolean>;
     slug: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -28,9 +28,9 @@ export declare const searchProductItemSchema: z.ZodObject<{
     status?: string | undefined;
     price?: number | undefined;
     featured?: boolean | undefined;
+    listingType?: "auction" | "standard" | "prize-draw" | "pre-order" | "bundle" | undefined;
     isPromoted?: boolean | undefined;
     mainImage?: string | undefined;
-    isAuction?: boolean | undefined;
 }, {
     id: string;
     title: string;
@@ -39,9 +39,9 @@ export declare const searchProductItemSchema: z.ZodObject<{
     status?: string | undefined;
     price?: number | undefined;
     featured?: boolean | undefined;
+    listingType?: "auction" | "standard" | "prize-draw" | "pre-order" | "bundle" | undefined;
     isPromoted?: boolean | undefined;
     mainImage?: string | undefined;
-    isAuction?: boolean | undefined;
 }>;
 /**
  * Form/query schema for a search request.

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

@@ -17,7 +17,9 @@ export const searchProductItemSchema = z.object({
     mainImage: z.string().optional(),
     status: z.string().optional(),
     featured: z.boolean().optional(),
-    isAuction: z.boolean().optional(),
+    listingType: z
+        .enum(["standard", "auction", "pre-order", "prize-draw", "bundle"])
+        .optional(),
     isPromoted: z.boolean().optional(),
     slug: z.string(),
 });

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

@@ -9,7 +9,7 @@ export interface SearchProductItem {
     status: string;
     featured?: boolean;
     /** Canonical listing-kind discriminator (SB1-G Phase 4). */
-    listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
+    listingType?: "standard" | "auction" | "pre-order" | "prize-draw";
     currentBid?: number;
     isPromoted?: boolean;
     slug: string;
@@ -32,7 +32,7 @@ export interface SearchQuery {
     maxPrice?: number;
     condition?: string;
     /** Canonical listing-kind discriminator (SB1-G Phase 4). */
-    listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
+    listingType?: "standard" | "auction" | "pre-order" | "prize-draw";
     inStock?: boolean;
     minRating?: number;
     sort?: string;

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

@@ -1,5 +1,5 @@
 import React from "react";
-export type ProductListingMode = "standard" | "auction" | "pre-order";
+export type ProductListingMode = "standard" | "auction" | "pre-order" | "prize-draw";
 export interface SellerProductDraft {
     title?: string;
     slug?: string;