@mohasinac/appkit 2.7.53 → 2.7.54

package/dist/features/pre-orders/components/PreOrdersIndexListing.js

@@ -19,17 +19,8 @@ import { useCategoryTree, categoriesToFacetOptions } from "../../categories/hook
 import { useBrands } from "../../products/hooks/useBrands";
 import { useBulkSelection } from "../../../react/hooks/useBulkSelection";
 import { TABLE_KEYS, VIEW_MODE } from "../../../constants/table-keys";
-import { sortBy } from "../../../constants/sort";
-import { PRODUCT_FIELDS } from "../../../constants/field-names";
-const DEFAULT_SORT = sortBy(PRODUCT_FIELDS.CREATED_AT);
-const PREORDER_SORT_OPTIONS = [
-    { value: sortBy(PRODUCT_FIELDS.CREATED_AT), label: "Newest First" },
-    { value: sortBy(PRODUCT_FIELDS.CREATED_AT, "ASC"), label: "Oldest First" },
-    { value: sortBy(PRODUCT_FIELDS.PRE_ORDER_DELIVERY_DATE, "ASC"), label: "Delivery: Soonest" },
-    { value: sortBy(PRODUCT_FIELDS.PRE_ORDER_DELIVERY_DATE), label: "Delivery: Furthest" },
-    { value: sortBy(PRODUCT_FIELDS.PRICE, "ASC"), label: "Price: Low to High" },
-    { value: sortBy(PRODUCT_FIELDS.PRICE), label: "Price: High to Low" },
-];
+import { PREORDER_SORT_OPTIONS } from "../../products/constants/sieve";
+const DEFAULT_SORT = PREORDER_SORT_OPTIONS[2].value;
 const FILTER_KEYS = [TABLE_KEYS.CATEGORY, TABLE_KEYS.BRAND, TABLE_KEYS.MIN_PRICE, TABLE_KEYS.MAX_PRICE, TABLE_KEYS.STORE_ID, TABLE_KEYS.PREORDER_STATUS, TABLE_KEYS.DATE_FROM, TABLE_KEYS.DATE_TO];
 export function PreOrdersIndexListing({ initialData, categorySlug, brandName }) {
     const table = useUrlTable({ defaults: { pageSize: "24", sort: DEFAULT_SORT } });

package/dist/features/products/api/[id]/route.js

@@ -21,9 +21,7 @@ import { sanitizeProductForPublic } from "../../utils/sanitize";
 const ERR_DB_NOT_REGISTERED = "Database provider not registered";
 const ERR_PRODUCT_NOT_FOUND = "Product not found";
 const UNAVAILABLE_PRODUCT_STATUSES = new Set([
-    "sold",
-    "out_of_stock",
-    "discontinued",
+    "archived",
 ]);
 function getRepo() {
     const { db } = getProviders();
@@ -43,10 +41,8 @@ const productUpdateSchema = z
         .enum([
         "draft",
         "published",
+        "in_review",
         "archived",
-        "sold",
-        "discontinued",
-        "out_of_stock",
     ])
         .optional(),
     mainImage: z.string().optional(),
@@ -145,7 +141,7 @@ export const PATCH = createRouteHandler({
     },
 });
 // --- DELETE /api/products/[id] ------------------------------------------------
-// Soft-delete (sets status to "discontinued"). Auth required.
+// Soft-delete (sets status to "archived"). Auth required.
 export const DELETE = createRouteHandler({
     auth: true,
     handler: async ({ user, params }) => {
@@ -166,7 +162,7 @@ export const DELETE = createRouteHandler({
             return NextResponse.json({ success: false, error: "Not authorized to delete this product" }, { status: 403 });
         }
         await repo.update(id, {
-            status: "discontinued",
+            status: "archived",
             updatedAt: new Date().toISOString(),
         });
         // SB-UNI-V — bundle stock-sync handled by onProductStockChange Function.

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

@@ -32,10 +32,8 @@ const productMutateSchema = z
         .enum([
         "draft",
         "published",
+        "in_review",
         "archived",
-        "sold",
-        "discontinued",
-        "out_of_stock",
     ])
         .optional(),
     mainImage: z.string().optional(),

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

@@ -13,19 +13,11 @@ import { pushWishlistOp } from "../../cart/utils/pending-ops";
 import { useCategoryTree, categoriesToFacetOptions } from "../../categories/hooks/useCategoryTree";
 import { useBrands } from "../hooks/useBrands";
 import { TABLE_KEYS, VIEW_MODE } from "../../../constants/table-keys";
-import { sortBy } from "../../../constants/sort";
-import { PRODUCT_FIELDS } from "../../../constants/field-names";
 import { useAuthGate } from "../../../react/hooks/useAuthGate";
 import { ACTION_ID } from "../constants/action-defs";
-const DEFAULT_SORT = sortBy(PRODUCT_FIELDS.AUCTION_END_DATE, "ASC");
-const AUCTION_SORT_OPTIONS = [
-    { value: sortBy(PRODUCT_FIELDS.AUCTION_END_DATE, "ASC"), label: "Ending Soonest" },
-    { value: sortBy(PRODUCT_FIELDS.AUCTION_END_DATE), label: "Ending Latest" },
-    { value: sortBy(PRODUCT_FIELDS.CURRENT_BID, "ASC"), label: "Bid: Low to High" },
-    { value: sortBy(PRODUCT_FIELDS.CURRENT_BID), label: "Bid: High to Low" },
-    { value: sortBy(PRODUCT_FIELDS.CREATED_AT), label: "Newly Listed" },
-    { value: sortBy(PRODUCT_FIELDS.CREATED_AT, "ASC"), label: "Oldest Listed" },
-];
+import { AUCTION_PUBLIC_SORT_OPTIONS } from "../constants/sieve";
+const DEFAULT_SORT = AUCTION_PUBLIC_SORT_OPTIONS[0].value;
+const AUCTION_SORT_OPTIONS = AUCTION_PUBLIC_SORT_OPTIONS;
 const FILTER_KEYS = [TABLE_KEYS.CATEGORY, TABLE_KEYS.BRAND, TABLE_KEYS.MIN_BID, TABLE_KEYS.MAX_BID, TABLE_KEYS.STORE_ID, TABLE_KEYS.DATE_FROM, TABLE_KEYS.DATE_TO];
 export function AuctionsIndexListing({ initialData, categorySlug, brandName }) {
     const table = useUrlTable({ defaults: { pageSize: "24", sort: DEFAULT_SORT } });

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

@@ -10,17 +10,9 @@ import { useBrands } from "../hooks/useBrands";
 import { MarketplacePrizeDrawCard } from "./MarketplacePrizeDrawCard";
 import { ProductFilters } from "./ProductFilters";
 import { TABLE_KEYS, VIEW_MODE } from "../../../constants/table-keys";
-import { sortBy } from "../../../constants/sort";
+import { PRIZE_DRAW_SORT_OPTIONS } from "../constants/sieve";
 import { PRODUCT_FIELDS } from "../../../constants/field-names";
-const DEFAULT_SORT = sortBy(PRODUCT_FIELDS.CREATED_AT);
-const PRIZE_DRAW_SORT_OPTIONS = [
-    { value: sortBy(PRODUCT_FIELDS.CREATED_AT), label: "Newest First" },
-    { value: sortBy(PRODUCT_FIELDS.CREATED_AT, "ASC"), label: "Oldest First" },
-    { value: sortBy(PRODUCT_FIELDS.PRIZE_REVEAL_WINDOW_START, "ASC"), label: "Reveal: Soonest" },
-    { value: sortBy(PRODUCT_FIELDS.PRIZE_REVEAL_WINDOW_START), label: "Reveal: Furthest" },
-    { value: sortBy(PRODUCT_FIELDS.PRICE, "ASC"), label: "Entry: Low to High" },
-    { value: sortBy(PRODUCT_FIELDS.PRICE), label: "Entry: High to Low" },
-];
+const DEFAULT_SORT = PRIZE_DRAW_SORT_OPTIONS[0].value;
 const FILTER_KEYS = [
     TABLE_KEYS.CATEGORY,
     TABLE_KEYS.BRAND,

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

@@ -15,18 +15,27 @@ export declare const PRODUCT_ADMIN_SORT_OPTIONS: readonly [{
 }, {
     readonly value: string;
     readonly label: "Oldest First";
+}, {
+    readonly value: string;
+    readonly label: "Price: Low to High";
 }, {
     readonly value: string;
     readonly label: "Price: High to Low";
 }, {
     readonly value: string;
-    readonly label: "Price: Low to High";
+    readonly label: "Name: A–Z";
 }, {
     readonly value: string;
-    readonly label: "Title A-Z";
+    readonly label: "Name: Z–A";
 }, {
     readonly value: string;
-    readonly label: "Title Z-A";
+    readonly label: "Featured First";
+}, {
+    readonly value: string;
+    readonly label: "Promoted First";
+}, {
+    readonly value: string;
+    readonly label: "Recently Updated";
 }, {
     readonly value: string;
     readonly label: "Most Viewed";
@@ -37,15 +46,30 @@ export declare const PRODUCT_SELLER_SORT_OPTIONS: readonly [{
 }, {
     readonly value: string;
     readonly label: "Oldest First";
+}, {
+    readonly value: string;
+    readonly label: "Price: Low to High";
 }, {
     readonly value: string;
     readonly label: "Price: High to Low";
 }, {
     readonly value: string;
-    readonly label: "Price: Low to High";
+    readonly label: "Name: A–Z";
 }, {
     readonly value: string;
-    readonly label: "Title A-Z";
+    readonly label: "Name: Z–A";
+}, {
+    readonly value: string;
+    readonly label: "Featured First";
+}, {
+    readonly value: string;
+    readonly label: "Promoted First";
+}, {
+    readonly value: string;
+    readonly label: "Recently Updated";
+}, {
+    readonly value: string;
+    readonly label: "Most Viewed";
 }];
 export declare const PRODUCT_PUBLIC_SORT_OPTIONS: readonly [{
     readonly value: string;
@@ -55,16 +79,16 @@ export declare const PRODUCT_PUBLIC_SORT_OPTIONS: readonly [{
     readonly label: "Oldest First";
 }, {
     readonly value: string;
-    readonly label: "Price: High to Low";
+    readonly label: "Price: Low to High";
 }, {
     readonly value: string;
-    readonly label: "Price: Low to High";
+    readonly label: "Price: High to Low";
 }, {
     readonly value: string;
-    readonly label: "Title A–Z";
+    readonly label: "Name: A–Z";
 }, {
     readonly value: string;
-    readonly label: "Title Z–A";
+    readonly label: "Name: Z–A";
 }, {
     readonly value: string;
     readonly label: "Most Viewed";

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

@@ -8,7 +8,7 @@ import { SwitchFilter } from "../../filters/SwitchFilter";
 import { Div } from "../../../ui";
 import { TABLE_KEYS } from "../../../constants/table-keys";
 import { PRODUCT_FIELDS } from "../../../constants/field-names";
-import { sortBy } from "../../../constants/sort";
+import { STANDARD_SORT_OPTIONS, STANDARD_PUBLIC_SORT_OPTIONS, } from "../constants/sieve";
 export const PRODUCT_FILTER_KEYS = {
     admin: [
         TABLE_KEYS.CATEGORY,
@@ -48,33 +48,9 @@ export const PRODUCT_FILTER_KEYS = {
         TABLE_KEYS.FEATURES,
     ],
 };
-const LABEL_PRICE_HIGH_TO_LOW = "Price: High to Low";
-const LABEL_PRICE_LOW_TO_HIGH = "Price: Low to High";
-export const PRODUCT_ADMIN_SORT_OPTIONS = [
-    { value: sortBy(PRODUCT_FIELDS.CREATED_AT), label: "Newest First" },
-    { value: sortBy(PRODUCT_FIELDS.CREATED_AT, "ASC"), label: "Oldest First" },
-    { value: sortBy(PRODUCT_FIELDS.PRICE), label: LABEL_PRICE_HIGH_TO_LOW },
-    { value: sortBy(PRODUCT_FIELDS.PRICE, "ASC"), label: LABEL_PRICE_LOW_TO_HIGH },
-    { value: sortBy(PRODUCT_FIELDS.TITLE, "ASC"), label: "Title A-Z" },
-    { value: sortBy(PRODUCT_FIELDS.TITLE), label: "Title Z-A" },
-    { value: sortBy(PRODUCT_FIELDS.VIEW_COUNT), label: "Most Viewed" },
-];
-export const PRODUCT_SELLER_SORT_OPTIONS = [
-    { value: sortBy(PRODUCT_FIELDS.CREATED_AT), label: "Newest First" },
-    { value: sortBy(PRODUCT_FIELDS.CREATED_AT, "ASC"), label: "Oldest First" },
-    { value: sortBy(PRODUCT_FIELDS.PRICE), label: LABEL_PRICE_HIGH_TO_LOW },
-    { value: sortBy(PRODUCT_FIELDS.PRICE, "ASC"), label: LABEL_PRICE_LOW_TO_HIGH },
-    { value: sortBy(PRODUCT_FIELDS.TITLE, "ASC"), label: "Title A-Z" },
-];
-export const PRODUCT_PUBLIC_SORT_OPTIONS = [
-    { value: sortBy(PRODUCT_FIELDS.CREATED_AT), label: "Newest First" },
-    { value: sortBy(PRODUCT_FIELDS.CREATED_AT, "ASC"), label: "Oldest First" },
-    { value: sortBy(PRODUCT_FIELDS.PRICE), label: LABEL_PRICE_HIGH_TO_LOW },
-    { value: sortBy(PRODUCT_FIELDS.PRICE, "ASC"), label: LABEL_PRICE_LOW_TO_HIGH },
-    { value: sortBy(PRODUCT_FIELDS.TITLE, "ASC"), label: "Title A–Z" },
-    { value: sortBy(PRODUCT_FIELDS.TITLE), label: "Title Z–A" },
-    { value: sortBy(PRODUCT_FIELDS.VIEW_COUNT), label: "Most Viewed" },
-];
+export const PRODUCT_ADMIN_SORT_OPTIONS = STANDARD_SORT_OPTIONS;
+export const PRODUCT_SELLER_SORT_OPTIONS = STANDARD_SORT_OPTIONS;
+export const PRODUCT_PUBLIC_SORT_OPTIONS = STANDARD_PUBLIC_SORT_OPTIONS;
 export function getProductFilterKeys(variant) {
     return PRODUCT_FILTER_KEYS[variant];
 }
@@ -102,7 +78,8 @@ export function ProductFilters({ table, categoryOptions = [], brandOptions = [],
     const defaultStatusOptions = [
         { value: PRODUCT_FIELDS.STATUS_VALUES.PUBLISHED, label: t("statusPublished") },
         { value: PRODUCT_FIELDS.STATUS_VALUES.DRAFT, label: t("statusDraft") },
-        { value: PRODUCT_FIELDS.STATUS_VALUES.OUT_OF_STOCK, label: t("statusOutOfStock") },
+        { value: PRODUCT_FIELDS.STATUS_VALUES.IN_REVIEW, label: t("statusInReview") },
+        { value: PRODUCT_FIELDS.STATUS_VALUES.ARCHIVED, label: t("statusArchived") },
     ];
     const splitPipe = (key) => table.get(key) ? table.get(key).split("|").filter(Boolean) : [];
     const selectedCategories = splitPipe(TABLE_KEYS.CATEGORY);

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

@@ -15,9 +15,8 @@ import { PrizeDrawItemsEditor } from "./PrizeDrawItemsEditor";
 export const PRODUCT_STATUS_OPTIONS = [
     { value: "draft", label: "Draft" },
     { value: "published", label: "Published" },
-    { value: "out_of_stock", label: "Out of Stock" },
-    { value: "discontinued", label: "Discontinued" },
-    { value: "sold", label: "Sold" },
+    { value: "in_review", label: "In Review" },
+    { value: "archived", label: "Archived" },
 ];
 function readFileAsDataUrl(file) {
     return new Promise((resolve) => {

package/dist/features/products/constants/sieve.d.ts

@@ -0,0 +1,162 @@
+export type SortOption = {
+    readonly value: string;
+    readonly label: string;
+};
+export declare const STANDARD_SORT_OPTIONS: readonly [{
+    readonly value: string;
+    readonly label: "Newest First";
+}, {
+    readonly value: string;
+    readonly label: "Oldest First";
+}, {
+    readonly value: string;
+    readonly label: "Price: Low to High";
+}, {
+    readonly value: string;
+    readonly label: "Price: High to Low";
+}, {
+    readonly value: string;
+    readonly label: "Name: A–Z";
+}, {
+    readonly value: string;
+    readonly label: "Name: Z–A";
+}, {
+    readonly value: string;
+    readonly label: "Featured First";
+}, {
+    readonly value: string;
+    readonly label: "Promoted First";
+}, {
+    readonly value: string;
+    readonly label: "Recently Updated";
+}, {
+    readonly value: string;
+    readonly label: "Most Viewed";
+}];
+export declare const STANDARD_PUBLIC_SORT_OPTIONS: readonly [{
+    readonly value: string;
+    readonly label: "Newest First";
+}, {
+    readonly value: string;
+    readonly label: "Oldest First";
+}, {
+    readonly value: string;
+    readonly label: "Price: Low to High";
+}, {
+    readonly value: string;
+    readonly label: "Price: High to Low";
+}, {
+    readonly value: string;
+    readonly label: "Name: A–Z";
+}, {
+    readonly value: string;
+    readonly label: "Name: Z–A";
+}, {
+    readonly value: string;
+    readonly label: "Most Viewed";
+}];
+export declare const AUCTION_SORT_OPTIONS: readonly [{
+    readonly value: string;
+    readonly label: "Ending Soon";
+}, {
+    readonly value: string;
+    readonly label: "Just Started";
+}, {
+    readonly value: string;
+    readonly label: "Lowest Current Bid";
+}, {
+    readonly value: string;
+    readonly label: "Highest Current Bid";
+}, {
+    readonly value: string;
+    readonly label: "Lowest Starting Bid";
+}, {
+    readonly value: string;
+    readonly label: "Most Bids";
+}, {
+    readonly value: string;
+    readonly label: "Fewest Bids";
+}, {
+    readonly value: string;
+    readonly label: "Buy It Now: Low–High";
+}, {
+    readonly value: string;
+    readonly label: "Oldest Listed";
+}];
+export declare const AUCTION_PUBLIC_SORT_OPTIONS: readonly [{
+    readonly value: string;
+    readonly label: "Ending Soon";
+}, {
+    readonly value: string;
+    readonly label: "Just Started";
+}, {
+    readonly value: string;
+    readonly label: "Lowest Current Bid";
+}, {
+    readonly value: string;
+    readonly label: "Highest Current Bid";
+}, {
+    readonly value: string;
+    readonly label: "Most Bids";
+}, {
+    readonly value: string;
+    readonly label: "Buy It Now: Low–High";
+}];
+export declare const PREORDER_SORT_OPTIONS: readonly [{
+    readonly value: string;
+    readonly label: "Earliest Delivery";
+}, {
+    readonly value: string;
+    readonly label: "Latest Delivery";
+}, {
+    readonly value: string;
+    readonly label: "Newest First";
+}, {
+    readonly value: string;
+    readonly label: "Price: Low to High";
+}, {
+    readonly value: string;
+    readonly label: "Price: High to Low";
+}, {
+    readonly value: string;
+    readonly label: "Fewest Slots Left";
+}, {
+    readonly value: string;
+    readonly label: "Lowest Deposit First";
+}];
+export declare const BUNDLE_SORT_OPTIONS: readonly [{
+    readonly value: string;
+    readonly label: "Newest First";
+}, {
+    readonly value: string;
+    readonly label: "Price: Low to High";
+}, {
+    readonly value: string;
+    readonly label: "Price: High to Low";
+}, {
+    readonly value: "-savingsAmount";
+    readonly label: "Most Savings";
+}, {
+    readonly value: "-bundleItemCount";
+    readonly label: "Most Items";
+}];
+export declare const PRIZE_DRAW_SORT_OPTIONS: readonly [{
+    readonly value: string;
+    readonly label: "Newest First";
+}, {
+    readonly value: string;
+    readonly label: "Oldest First";
+}, {
+    readonly value: string;
+    readonly label: "Reveal: Soonest";
+}, {
+    readonly value: string;
+    readonly label: "Reveal: Furthest";
+}, {
+    readonly value: string;
+    readonly label: "Entry: Low to High";
+}, {
+    readonly value: string;
+    readonly label: "Entry: High to Low";
+}];
+export declare const SORT_OPTIONS_BY_LISTING_TYPE: Record<string, readonly SortOption[]>;

package/dist/features/products/constants/sieve.js

@@ -0,0 +1,95 @@
+import { sortBy } from "../../../constants/sort";
+import { PRODUCT_FIELDS } from "../../../constants/field-names";
+const LABEL_PRICE_HIGH = "Price: High to Low";
+const LABEL_PRICE_LOW = "Price: Low to High";
+const LABEL_NEWEST = "Newest First";
+const LABEL_OLDEST = "Oldest First";
+// ---------------------------------------------------------------------------
+// Standard Products
+// ---------------------------------------------------------------------------
+export const STANDARD_SORT_OPTIONS = [
+    { value: sortBy(PRODUCT_FIELDS.CREATED_AT), label: LABEL_NEWEST },
+    { value: sortBy(PRODUCT_FIELDS.CREATED_AT, "ASC"), label: LABEL_OLDEST },
+    { value: sortBy(PRODUCT_FIELDS.PRICE, "ASC"), label: LABEL_PRICE_LOW },
+    { value: sortBy(PRODUCT_FIELDS.PRICE), label: LABEL_PRICE_HIGH },
+    { value: sortBy(PRODUCT_FIELDS.TITLE, "ASC"), label: "Name: A–Z" },
+    { value: sortBy(PRODUCT_FIELDS.TITLE), label: "Name: Z–A" },
+    { value: sortBy(PRODUCT_FIELDS.FEATURED), label: "Featured First" },
+    { value: sortBy(PRODUCT_FIELDS.IS_PROMOTED), label: "Promoted First" },
+    { value: sortBy(PRODUCT_FIELDS.UPDATED_AT), label: "Recently Updated" },
+    { value: sortBy(PRODUCT_FIELDS.VIEW_COUNT), label: "Most Viewed" },
+];
+export const STANDARD_PUBLIC_SORT_OPTIONS = [
+    STANDARD_SORT_OPTIONS[0],
+    STANDARD_SORT_OPTIONS[1],
+    STANDARD_SORT_OPTIONS[2],
+    STANDARD_SORT_OPTIONS[3],
+    STANDARD_SORT_OPTIONS[4],
+    STANDARD_SORT_OPTIONS[5],
+    STANDARD_SORT_OPTIONS[9],
+];
+// ---------------------------------------------------------------------------
+// Auctions
+// ---------------------------------------------------------------------------
+export const AUCTION_SORT_OPTIONS = [
+    { value: sortBy(PRODUCT_FIELDS.AUCTION_END_DATE, "ASC"), label: "Ending Soon" },
+    { value: sortBy(PRODUCT_FIELDS.CREATED_AT), label: "Just Started" },
+    { value: sortBy(PRODUCT_FIELDS.CURRENT_BID, "ASC"), label: "Lowest Current Bid" },
+    { value: sortBy(PRODUCT_FIELDS.CURRENT_BID), label: "Highest Current Bid" },
+    { value: sortBy(PRODUCT_FIELDS.STARTING_BID, "ASC"), label: "Lowest Starting Bid" },
+    { value: sortBy(PRODUCT_FIELDS.BID_COUNT), label: "Most Bids" },
+    { value: sortBy(PRODUCT_FIELDS.BID_COUNT, "ASC"), label: "Fewest Bids" },
+    { value: sortBy(PRODUCT_FIELDS.BUY_NOW_PRICE, "ASC"), label: "Buy It Now: Low–High" },
+    { value: sortBy(PRODUCT_FIELDS.CREATED_AT, "ASC"), label: "Oldest Listed" },
+];
+export const AUCTION_PUBLIC_SORT_OPTIONS = [
+    AUCTION_SORT_OPTIONS[0],
+    AUCTION_SORT_OPTIONS[1],
+    AUCTION_SORT_OPTIONS[2],
+    AUCTION_SORT_OPTIONS[3],
+    AUCTION_SORT_OPTIONS[5],
+    AUCTION_SORT_OPTIONS[7],
+];
+// ---------------------------------------------------------------------------
+// Pre-Orders
+// ---------------------------------------------------------------------------
+export const PREORDER_SORT_OPTIONS = [
+    { value: sortBy(PRODUCT_FIELDS.PRE_ORDER_DELIVERY_DATE, "ASC"), label: "Earliest Delivery" },
+    { value: sortBy(PRODUCT_FIELDS.PRE_ORDER_DELIVERY_DATE), label: "Latest Delivery" },
+    { value: sortBy(PRODUCT_FIELDS.CREATED_AT), label: LABEL_NEWEST },
+    { value: sortBy(PRODUCT_FIELDS.PRICE, "ASC"), label: LABEL_PRICE_LOW },
+    { value: sortBy(PRODUCT_FIELDS.PRICE), label: LABEL_PRICE_HIGH },
+    { value: sortBy(PRODUCT_FIELDS.PRE_ORDER_CURRENT_COUNT), label: "Fewest Slots Left" },
+    { value: sortBy(PRODUCT_FIELDS.PRE_ORDER_DEPOSIT_AMOUNT, "ASC"), label: "Lowest Deposit First" },
+];
+// ---------------------------------------------------------------------------
+// Bundles
+// ---------------------------------------------------------------------------
+export const BUNDLE_SORT_OPTIONS = [
+    { value: sortBy(PRODUCT_FIELDS.CREATED_AT), label: LABEL_NEWEST },
+    { value: sortBy(PRODUCT_FIELDS.PRICE, "ASC"), label: LABEL_PRICE_LOW },
+    { value: sortBy(PRODUCT_FIELDS.PRICE), label: LABEL_PRICE_HIGH },
+    { value: "-savingsAmount", label: "Most Savings" },
+    { value: "-bundleItemCount", label: "Most Items" },
+];
+// ---------------------------------------------------------------------------
+// Prize Draws
+// ---------------------------------------------------------------------------
+export const PRIZE_DRAW_SORT_OPTIONS = [
+    { value: sortBy(PRODUCT_FIELDS.CREATED_AT), label: LABEL_NEWEST },
+    { value: sortBy(PRODUCT_FIELDS.CREATED_AT, "ASC"), label: LABEL_OLDEST },
+    { value: sortBy(PRODUCT_FIELDS.PRIZE_REVEAL_WINDOW_START, "ASC"), label: "Reveal: Soonest" },
+    { value: sortBy(PRODUCT_FIELDS.PRIZE_REVEAL_WINDOW_START), label: "Reveal: Furthest" },
+    { value: sortBy(PRODUCT_FIELDS.PRICE, "ASC"), label: "Entry: Low to High" },
+    { value: sortBy(PRODUCT_FIELDS.PRICE), label: "Entry: High to Low" },
+];
+// ---------------------------------------------------------------------------
+// Lookup by listing type
+// ---------------------------------------------------------------------------
+export const SORT_OPTIONS_BY_LISTING_TYPE = {
+    standard: STANDARD_SORT_OPTIONS,
+    auction: AUCTION_SORT_OPTIONS,
+    "pre-order": PREORDER_SORT_OPTIONS,
+    bundle: BUNDLE_SORT_OPTIONS,
+    "prize-draw": PRIZE_DRAW_SORT_OPTIONS,
+};

package/dist/features/products/repository/products.repository.d.ts

@@ -202,6 +202,10 @@ export declare class ProductRepository extends BaseRepository<ProductDocument> {
             canFilter: boolean;
             canSort: boolean;
         };
+        searchTokens: {
+            canFilter: boolean;
+            canSort: boolean;
+        };
     };
     /**
      * Virtual filter aliases — callers can pass `f=listingType==auction` for
@@ -216,6 +220,7 @@ export declare class ProductRepository extends BaseRepository<ProductDocument> {
         storeId?: string;
         status?: string;
         categoriesIn?: string[];
+        search?: string;
     }): Promise<FirebaseSieveResult<ProductDocument>>;
     incrementViewCount(productId: string): Promise<void>;
     /**

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

@@ -2,7 +2,7 @@ import { increment, serverTimestamp } from "../../../contracts/field-ops";
 import { DatabaseError } from "../../../errors";
 import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
 import { cacheManager } from "../../../core";
-import { generateUniqueId, slugify } from "../../../utils";
+import { generateUniqueId, slugify, buildSearchTokens, tokenizeQuery } from "../../../utils";
 import { PRODUCT_COLLECTION, ProductStatusValues, } from "../schemas";
 import { PRODUCT_FIELDS } from "../../../constants/field-names";
 /**
@@ -35,6 +35,9 @@ function buildListingKindClause(kind, inverted) {
     const op = inverted ? "!=" : "==";
     return `${PRODUCT_FIELDS.LISTING_TYPE}${op}${canonical}`;
 }
+function buildProductSearchTokens(p) {
+    return buildSearchTokens(p.title, p.description, p.brand, p.brandSlug, p.categoryNames, p.tags, p.features, p.condition, p.card?.setName, p.card?.cardNumber, p.grading?.service, p.specifications?.map((s) => `${s.name} ${s.value}`));
+}
 export class ProductRepository extends BaseRepository {
     constructor() {
         super(PRODUCT_COLLECTION);
@@ -80,7 +83,12 @@ export class ProductRepository extends BaseRepository {
     }
     async update(id, data) {
         this.cacheInvalidateForId(id);
-        const updated = await super.update(id, data);
+        const current = await super.findById(id);
+        const merged = { ...current, ...data };
+        const updated = await super.update(id, {
+            ...data,
+            searchTokens: buildProductSearchTokens(merged),
+        });
         this.cacheSet(updated);
         return updated;
     }
@@ -100,6 +108,7 @@ export class ProductRepository extends BaseRepository {
             ...input,
             slug: id,
             availableQuantity: input.stockQuantity,
+            searchTokens: buildProductSearchTokens(input),
             createdAt: new Date(),
             updatedAt: new Date(),
         };
@@ -320,7 +329,17 @@ export class ProductRepository extends BaseRepository {
         if (opts?.storeId) {
             baseQuery = baseQuery.where(PRODUCT_FIELDS.STORE_ID, "==", opts.storeId);
         }
-        if (opts?.categoriesIn && opts.categoriesIn.length > 0) {
+        const searchTokens = tokenizeQuery(opts?.search ?? "");
+        if (searchTokens.length > 0 && opts?.categoriesIn && opts.categoriesIn.length > 0) {
+            // Firestore cannot combine two array operators in one query
+        }
+        else if (searchTokens.length === 1) {
+            baseQuery = baseQuery.where("searchTokens", "array-contains", searchTokens[0]);
+        }
+        else if (searchTokens.length > 1) {
+            baseQuery = baseQuery.where("searchTokens", "array-contains-any", searchTokens);
+        }
+        if (searchTokens.length === 0 && opts?.categoriesIn && opts.categoriesIn.length > 0) {
             baseQuery = baseQuery.where(PRODUCT_FIELDS.CATEGORY_SLUGS, "array-contains-any", opts.categoriesIn);
         }
         return this.sieveQuery(model, ProductRepository.SIEVE_FIELDS, {
@@ -464,6 +483,7 @@ ProductRepository.SIEVE_FIELDS = {
     insurance: { canFilter: true, canSort: false },
     currency: { canFilter: true, canSort: false },
     freeShipping: { canFilter: true, canSort: false },
+    searchTokens: { canFilter: true, canSort: false },
 };
 /**
  * Virtual filter aliases — callers can pass `f=listingType==auction` for

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

@@ -169,6 +169,7 @@ export interface ProductDocument {
     preOrderCurrentCount?: number;
     preOrderProductionStatus?: "upcoming" | "in_production" | "ready_to_ship";
     preOrderCancellable?: boolean;
+    preOrderClosed?: boolean;
     isPromoted?: boolean;
     isOnSale?: boolean;
     isSold?: boolean;
@@ -246,6 +247,7 @@ export interface ProductDocument {
         shelf: string;
         bin: string;
     };
+    searchTokens?: string[];
     createdAt: Date;
     updatedAt: Date;
 }
@@ -271,13 +273,11 @@ export interface PrizeDrawItem {
 export declare const ProductStatusValues: {
     readonly DRAFT: "draft";
     readonly PUBLISHED: "published";
+    readonly IN_REVIEW: "in_review";
     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 ["storeId", "status", "category", "featured", "listingType", "isPromoted", "isOnSale", "isSold", "createdAt"];
+export declare const PRODUCT_INDEXED_FIELDS: readonly ["storeId", "status", "category", "featured", "listingType", "isPromoted", "isOnSale", "isSold", "searchTokens", "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", "listingType", "auctionEndDate", "startingBid", "currentBid", "bidCount", "reservePrice", "buyNowPrice", "minBidIncrement", "autoExtendable", "auctionExtensionMinutes", "auctionShippingPaidBy", "buyItNowPriceInPaise", "bidsHaveStarted", "grading", "card", "classified", "digitalCode", "liveItem", "catalogProductId", "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", "buyItNowPriceInPaise", "bidsHaveStarted", "grading", "card", "classified", "digitalCode", "liveItem", "catalogProductId", "listingType", "preOrderDeliveryDate", "preOrderDepositPercent", "preOrderDepositAmount", "preOrderMaxQuantity", "preOrderProductionStatus", "preOrderCancellable", "isOnSale", "isSold", "seoTitle", "seoDescription", "seoKeywords", "customFields", "customSections", "sublistingCategoryId", "groupId", "isGroupParent", "groupParentSlug", "groupChildSlugs", "groupTitle"];