@mohasinac/appkit 2.8.3 → 2.8.4

package/dist/features/auctions/actions/bid-actions.js

@@ -4,6 +4,8 @@
  * Business logic for auction bidding. Auth, rate-limiting, and
  * input validation are handled by the calling server action.
  */
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
+import { sortBy } from "@mohasinac/appkit";
 import { serverLogger } from "../../../monitoring";
 import { bidRepository } from "../repository/bid.repository";
 import { productRepository } from "../../products/repository/products.repository";
@@ -215,8 +217,8 @@ export async function buyNowAuction(userId, userName, userEmail, input) {
 }
 export async function listBidsByProduct(productId, params) {
     const result = await bidRepository.list({
-        filters: `productId==${productId}`,
-        sorts: "-bidDate",
+        filters: sieveFilter("productId", SIEVE_OP.EQ, productId),
+        sorts: sortBy("bidDate", "DESC"),
         page: params?.page ?? 1,
         pageSize: params?.pageSize ?? 20,
     });

package/dist/features/auctions/components/AuctionsListView.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
 import { productRepository } from "../../../repositories";
 import { Container, Heading, Main, Section } from "../../../ui";
 import { AdSlot } from "../../homepage/components/AdSlot";
@@ -16,23 +17,23 @@ function buildAuctionFilters(params) {
     const minBid = sp(params, "minBid");
     const maxBid = sp(params, "maxBid");
     if (minBid)
-        parts.push(`currentBid>=${minBid}`);
+        parts.push(sieveFilter("currentBid", SIEVE_OP.GTE, minBid));
     if (maxBid)
-        parts.push(`currentBid<=${maxBid}`);
+        parts.push(sieveFilter("currentBid", SIEVE_OP.LTE, maxBid));
     const store = sp(params, "store");
     if (store) {
         const values = store.split("|").filter(Boolean);
         if (values.length === 1)
-            parts.push(`storeId==${values[0]}`);
+            parts.push(sieveFilter("storeId", SIEVE_OP.EQ, values[0]));
         else if (values.length > 1)
-            parts.push(`storeId==${values.join("|")}`);
+            parts.push(sieveFilter("storeId", SIEVE_OP.EQ, values.join("|")));
     }
     const dateFrom = sp(params, "dateFrom");
     const dateTo = sp(params, "dateTo");
     if (dateFrom)
-        parts.push(`auctionEndDate>=${dateFrom}`);
+        parts.push(sieveFilter("auctionEndDate", SIEVE_OP.GTE, dateFrom));
     if (dateTo)
-        parts.push(`auctionEndDate<=${dateTo}`);
+        parts.push(sieveFilter("auctionEndDate", SIEVE_OP.LTE, dateTo));
     return parts.join(",");
 }
 export async function AuctionsListView({ searchParams = {} }) {

package/dist/features/auctions/hooks/useAuctions.d.ts

@@ -17,22 +17,22 @@ interface UseAuctionDetailOptions {
     bidsQueryKeyPrefix?: string;
 }
 export declare function useAuctions(params?: AuctionListQuery, opts?: UseAuctionsOptions): {
-    data: NoInfer<AuctionListResponse> | undefined;
+    data: AuctionListResponse | undefined;
     auctions: AuctionItem[];
     total: number;
     totalPages: number;
     hasMore: boolean;
     isLoading: boolean;
     error: string | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<AuctionListResponse>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<AuctionListResponse, Error>>;
 };
 export declare function useAuction(slug: string, opts?: {
     enabled?: boolean;
 }): {
-    auction: NonNullable<NoInfer<AuctionItem | null>> | null;
+    auction: AuctionItem | null;
     isLoading: boolean;
     error: string | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<AuctionItem | null>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<AuctionItem | null, Error>>;
 };
 export declare function useAuctionBids(auctionSlug: string, limit?: number, opts?: {
     enabled?: boolean;
@@ -43,9 +43,9 @@ export declare function useAuctionBids(auctionSlug: string, limit?: number, opts
     error: string | null;
 };
 export declare function useAuctionDetail(id: string, opts?: UseAuctionDetailOptions): {
-    productQuery: import("@tanstack/react-query").UseQueryResult<NoInfer<ProductItem | null>, Error>;
-    product: NonNullable<NoInfer<ProductItem | null>> | null;
-    bidsQuery: import("@tanstack/react-query").UseQueryResult<NoInfer<PublicBid[]>, Error>;
-    bids: NoInfer<PublicBid[]>;
+    productQuery: import("@tanstack/react-query").UseQueryResult<ProductItem | null, Error>;
+    product: ProductItem | null;
+    bidsQuery: import("@tanstack/react-query").UseQueryResult<PublicBid[], Error>;
+    bids: PublicBid[];
 };
 export {};

package/dist/features/auth/hooks/useAuth.d.ts

@@ -4,11 +4,11 @@ interface UseCurrentUserOptions {
     enabled?: boolean;
 }
 export declare function useCurrentUser(opts?: UseCurrentUserOptions): {
-    user: NonNullable<NoInfer<AuthUser | null>> | null;
+    user: AuthUser | null;
     isLoading: boolean;
     isAuthenticated: boolean;
     error: Error | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<AuthUser | null>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<AuthUser | null, Error>>;
 };
 export interface LoginCredentials {
     email: string;

package/dist/features/blog/actions/blog-actions.js

@@ -1,3 +1,4 @@
+import { sortBy } from "@mohasinac/appkit";
 import { z } from "zod";
 import { serverLogger } from "../../../monitoring";
 import { blogRepository } from "../repository/blog.repository";
@@ -104,11 +105,11 @@ export async function listBlogPosts(params) {
     return blogRepository.listPublished({ category: params?.category }, sieve);
 }
 export async function getFeaturedBlogPosts(count = 3) {
-    const result = await blogRepository.listPublished({ featuredOnly: true }, { sorts: "-publishedAt", page: 1, pageSize: count });
+    const result = await blogRepository.listPublished({ featuredOnly: true }, { sorts: sortBy("publishedAt", "DESC"), page: 1, pageSize: count });
     return result.items;
 }
 export async function getLatestBlogPosts(count = 5) {
-    const result = await blogRepository.listPublished({}, { sorts: "-publishedAt", page: 1, pageSize: count });
+    const result = await blogRepository.listPublished({}, { sorts: sortBy("publishedAt", "DESC"), page: 1, pageSize: count });
     return result.items;
 }
 export async function getBlogPostById(id) {

package/dist/features/cart/hooks/useCart.d.ts

@@ -12,6 +12,6 @@ export declare function useCart(userIdOrSession: string, opts?: UseCartOptions):
     itemCount: number;
     isLoading: boolean;
     error: Error | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<CartData>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<CartData, Error>>;
 };
 export {};

package/dist/features/cart/hooks/useCartQuery.d.ts

@@ -4,5 +4,5 @@ interface UseCartQueryOptions<TData> {
     enabled?: boolean;
     initialData?: TData;
 }
-export declare function useCartQuery<TData = unknown>(options: UseCartQueryOptions<TData>): import("@tanstack/react-query").UseQueryResult<NoInfer<TData>, Error>;
+export declare function useCartQuery<TData = unknown>(options: UseCartQueryOptions<TData>): import("@tanstack/react-query").UseQueryResult<import("@tanstack/query-core").NoInfer<TData>, Error>;
 export {};

package/dist/features/cart/hooks/useCheckoutReadQueries.d.ts

@@ -8,7 +8,7 @@ interface UseCheckoutReadQueriesOptions<TAddress, TCart> {
     initialCart?: TCart;
 }
 export declare function useCheckoutReadQueries<TAddress = unknown, TCart = unknown>(options: UseCheckoutReadQueriesOptions<TAddress, TCart>): {
-    addressQuery: import("@tanstack/react-query").UseQueryResult<NoInfer<TAddress[]>, Error>;
-    cartQuery: import("@tanstack/react-query").UseQueryResult<NoInfer<TCart>, Error>;
+    addressQuery: import("@tanstack/react-query").UseQueryResult<TAddress[], Error>;
+    cartQuery: import("@tanstack/react-query").UseQueryResult<import("@tanstack/query-core").NoInfer<TCart>, Error>;
 };
 export {};

package/dist/features/cart/hooks/useOrder.d.ts

@@ -5,9 +5,9 @@ interface UseOrderOptions<TOrder> {
     initialData?: TOrder | null;
 }
 export declare function useOrder<TOrder = unknown>(orderId: string | null, options?: UseOrderOptions<TOrder>): {
-    order: NonNullable<NoInfer<TOrder | null>> | null;
+    order: NonNullable<import("@tanstack/query-core").NoInfer<TOrder | null>> | null;
     isLoading: boolean;
     error: Error | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<TOrder | null>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("@tanstack/query-core").NoInfer<TOrder | null>, Error>>;
 };
 export {};

package/dist/features/categories/components/BrandDetailPageView.js

@@ -1,4 +1,6 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { sieveFilter, sieveAnd, SIEVE_OP } from "@mohasinac/appkit";
+import { sortBy } from "@mohasinac/appkit";
 import Link from "next/link";
 import { categoriesRepository, productRepository, } from "../../../repositories";
 import { ROUTES } from "../../../next";
@@ -16,8 +18,8 @@ export async function BrandDetailPageView({ slug, initialBrand }) {
         brandName
             ? productRepository
                 .list({
-                filters: `status==published,brand==${brandName},listingType==standard`,
-                sorts: "-createdAt",
+                filters: sieveAnd(sieveFilter("status", SIEVE_OP.EQ, "published"), sieveFilter("brand", SIEVE_OP.EQ, brandName), sieveFilter("listingType", SIEVE_OP.EQ, "standard")),
+                sorts: sortBy("createdAt", "DESC"),
                 page: 1,
                 pageSize: 24,
             })
@@ -26,8 +28,8 @@ export async function BrandDetailPageView({ slug, initialBrand }) {
         brandName
             ? productRepository
                 .list({
-                filters: `status==published,brand==${brandName},listingType==auction`,
-                sorts: "auctionEndDate",
+                filters: sieveAnd(sieveFilter("status", SIEVE_OP.EQ, "published"), sieveFilter("brand", SIEVE_OP.EQ, brandName), sieveFilter("listingType", SIEVE_OP.EQ, "auction")),
+                sorts: sortBy("auctionEndDate", "ASC"),
                 page: 1,
                 pageSize: 1,
             })
@@ -36,8 +38,8 @@ export async function BrandDetailPageView({ slug, initialBrand }) {
         brandName
             ? productRepository
                 .list({
-                filters: `status==published,brand==${brandName},listingType==pre-order`,
-                sorts: "-createdAt",
+                filters: sieveAnd(sieveFilter("status", SIEVE_OP.EQ, "published"), sieveFilter("brand", SIEVE_OP.EQ, brandName), sieveFilter("listingType", SIEVE_OP.EQ, "pre-order")),
+                sorts: sortBy("createdAt", "DESC"),
                 page: 1,
                 pageSize: 1,
             })
@@ -46,8 +48,8 @@ export async function BrandDetailPageView({ slug, initialBrand }) {
         brandName
             ? productRepository
                 .list({
-                filters: `status==published,brand==${brandName},listingType==prize-draw`,
-                sorts: "-createdAt",
+                filters: sieveAnd(sieveFilter("status", SIEVE_OP.EQ, "published"), sieveFilter("brand", SIEVE_OP.EQ, brandName), sieveFilter("listingType", SIEVE_OP.EQ, "prize-draw")),
+                sorts: sortBy("createdAt", "DESC"),
                 page: 1,
                 pageSize: 1,
             })

package/dist/features/categories/components/CategoriesIndexListing.js

@@ -43,7 +43,7 @@ const FILTER_KEYS = [TABLE_KEYS.IS_FEATURED, "isBrand", "rootOnly", "tier", "min
 const SORT_OPTIONS = [
     { value: sortBy(CATEGORY_FIELDS.NAME, "ASC"), label: "Name A–Z" },
     { value: sortBy(CATEGORY_FIELDS.NAME), label: "Name Z–A" },
-    { value: "-productCount", label: "Most Products" },
+    { value: sortBy("productCount", "DESC"), label: "Most Products" },
 ];
 export function CategoriesIndexListing({ initialData: _, brandsOnly = false }) {
     const table = useUrlTable({ defaults: { pageSize: String(PAGE_SIZE), sort: DEFAULT_SORT } });

package/dist/features/categories/components/CategoriesIndexPageView.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
 import { categoriesRepository } from "../../../repositories";
 import { Container, Heading, Main, Section } from "../../../ui";
 import { AdSlot } from "../../homepage/components/AdSlot";
@@ -21,16 +22,16 @@ function buildCategoryFilters(params) {
     const minItemCount = sp(params, "minItemCount");
     const maxItemCount = sp(params, "maxItemCount");
     if (minItemCount)
-        parts.push(`metrics.totalItemCount>=${minItemCount}`);
+        parts.push(sieveFilter("metrics.totalItemCount", SIEVE_OP.GTE, minItemCount));
     if (maxItemCount)
-        parts.push(`metrics.totalItemCount<=${maxItemCount}`);
+        parts.push(sieveFilter("metrics.totalItemCount", SIEVE_OP.LTE, maxItemCount));
     const tier = sp(params, "tier");
     if (tier) {
         const values = tier.split("|").filter(Boolean);
         if (values.length === 1)
-            parts.push(`tier==${values[0]}`);
+            parts.push(sieveFilter("tier", SIEVE_OP.EQ, values[0]));
         else if (values.length > 1)
-            parts.push(`tier==${values.join("|")}`);
+            parts.push(sieveFilter("tier", SIEVE_OP.EQ, values.join("|")));
     }
     return parts.join(",");
 }

package/dist/features/categories/components/CategoryBundlesListing.js

@@ -8,6 +8,7 @@ import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
  * All data is server-fetched; this component owns URL-state driven
  * sort/search/filter/pagination on top of the initial snapshot.
  */
+import { sortBy } from "@mohasinac/appkit";
 import { useMemo, useCallback, useState } from "react";
 import { Div, Span, Text } from "../../../ui";
 import { ListingToolbar, Pagination, FilterDrawer } from "../../../ui";
@@ -21,10 +22,10 @@ const __P = {
 const PAGE_SIZE = 12;
 const FILTER_KEYS = ["showOutOfStock"];
 const SORT_OPTIONS = [
-    { value: "-createdAt", label: "Newest First" },
-    { value: "createdAt", label: "Oldest First" },
-    { value: "price", label: "Price: Low to High" },
-    { value: "-price", label: "Price: High to Low" },
+    { value: sortBy("createdAt", "DESC"), label: "Newest First" },
+    { value: sortBy("createdAt", "ASC"), label: "Oldest First" },
+    { value: sortBy("price", "ASC"), label: "Price: Low to High" },
+    { value: sortBy("price", "DESC"), label: "Price: High to Low" },
 ];
 const DEFAULT_SORT = "-createdAt";
 export function CategoryBundlesListing({ initialBundles, brandName, onBuyNow, }) {

package/dist/features/categories/components/CategoryDetailPageView.js

@@ -1,4 +1,6 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { sieveAnd, sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
+import { sortBy } from "@mohasinac/appkit";
 import Link from "next/link";
 import { categoriesRepository, productRepository, storeRepository, } from "../../../repositories";
 import { ROUTES } from "../../../next";
@@ -14,13 +16,13 @@ export async function CategoryDetailPageView({ slug }) {
         .catch(() => undefined);
     // Use categorySlugs@=<id> (array-contains) — products store category FK in
     // the categorySlugs[] array, not the legacy `category` string field.
-    const catFilter = category?.id ? `categorySlugs@=${category.id}` : null;
+    const catFilter = category?.id ? sieveFilter("categorySlugs", SIEVE_OP.CONTAINS, category.id) : null;
     const [productsResult, auctionsCountResult, preOrdersCountResult, prizeDrawsCountResult, bundlesResult, childCategories] = await Promise.all([
         catFilter
             ? productRepository
                 .list({
-                filters: `status==published,${catFilter},listingType==standard`,
-                sorts: "-createdAt",
+                filters: sieveAnd(sieveFilter("status", SIEVE_OP.EQ, "published"), catFilter, sieveFilter("listingType", SIEVE_OP.EQ, "standard")),
+                sorts: sortBy("createdAt", "DESC"),
                 page: 1,
                 pageSize: 24,
             })
@@ -29,8 +31,8 @@ export async function CategoryDetailPageView({ slug }) {
         catFilter
             ? productRepository
                 .list({
-                filters: `status==published,${catFilter},listingType==auction`,
-                sorts: "auctionEndDate",
+                filters: sieveAnd(sieveFilter("status", SIEVE_OP.EQ, "published"), catFilter, sieveFilter("listingType", SIEVE_OP.EQ, "auction")),
+                sorts: sortBy("auctionEndDate", "ASC"),
                 page: 1,
                 pageSize: 1,
             })
@@ -39,8 +41,8 @@ export async function CategoryDetailPageView({ slug }) {
         catFilter
             ? productRepository
                 .list({
-                filters: `status==published,${catFilter},listingType==pre-order`,
-                sorts: "-createdAt",
+                filters: sieveAnd(sieveFilter("status", SIEVE_OP.EQ, "published"), catFilter, sieveFilter("listingType", SIEVE_OP.EQ, "pre-order")),
+                sorts: sortBy("createdAt", "DESC"),
                 page: 1,
                 pageSize: 1,
             })
@@ -49,8 +51,8 @@ export async function CategoryDetailPageView({ slug }) {
         catFilter
             ? productRepository
                 .list({
-                filters: `status==published,${catFilter},listingType==prize-draw`,
-                sorts: "-createdAt",
+                filters: sieveAnd(sieveFilter("status", SIEVE_OP.EQ, "published"), catFilter, sieveFilter("listingType", SIEVE_OP.EQ, "prize-draw")),
+                sorts: sortBy("createdAt", "DESC"),
                 page: 1,
                 pageSize: 1,
             })
@@ -73,7 +75,7 @@ export async function CategoryDetailPageView({ slug }) {
         ...childCategories.map((c) => c.slug).filter(Boolean),
     ];
     const storeResults = await Promise.all(storeCategorySlugs.map((catSlug) => storeRepository
-        .listStores({ filters: `storeCategory==${catSlug}`, page: 1, pageSize: 50 }, true)
+        .listStores({ filters: sieveFilter("storeCategory", SIEVE_OP.EQ, catSlug), page: 1, pageSize: 50 }, true)
         .catch(() => null)));
     const seen = new Set();
     const categoryStores = storeResults

package/dist/features/categories/components/CategoryFilters.d.ts

@@ -9,51 +9,51 @@ export declare const CATEGORY_ADMIN_SORT_OPTIONS: readonly [{
     readonly value: "order";
     readonly label: "Order Asc";
 }, {
-    readonly value: "-order";
+    readonly value: string;
     readonly label: "Order Desc";
 }, {
-    readonly value: "name";
+    readonly value: string;
     readonly label: "Name A-Z";
 }, {
-    readonly value: "-name";
+    readonly value: string;
     readonly label: "Name Z-A";
 }, {
     readonly value: "tier";
     readonly label: "Tier Low to High";
 }, {
-    readonly value: "-tier";
+    readonly value: string;
     readonly label: "Tier High to Low";
 }, {
-    readonly value: "-metrics.totalItemCount";
+    readonly value: string;
     readonly label: "Most Items";
 }, {
-    readonly value: "-createdAt";
+    readonly value: string;
     readonly label: "Newest First";
 }];
 export declare const CATEGORY_SELLER_SORT_OPTIONS: readonly [{
     readonly value: "order";
     readonly label: "Order Asc";
 }, {
-    readonly value: "name";
+    readonly value: string;
     readonly label: "Name A-Z";
 }, {
-    readonly value: "-name";
+    readonly value: string;
     readonly label: "Name Z-A";
 }, {
-    readonly value: "-metrics.totalItemCount";
+    readonly value: string;
     readonly label: "Most Items";
 }];
 export declare const CATEGORY_PUBLIC_SORT_OPTIONS: readonly [{
     readonly value: "order";
     readonly label: "Recommended";
 }, {
-    readonly value: "name";
+    readonly value: string;
     readonly label: "Name A-Z";
 }, {
-    readonly value: "-name";
+    readonly value: string;
     readonly label: "Name Z-A";
 }, {
-    readonly value: "-metrics.totalItemCount";
+    readonly value: string;
     readonly label: "Most Items";
 }];
 export declare function getCategoryFilterKeys(variant: CategoryFilterVariant): readonly string[];

package/dist/features/categories/components/CategoryFilters.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { sortBy } from "@mohasinac/appkit";
 import { useTranslations } from "next-intl";
 import { FilterFacetSection } from "../../filters/FilterFacetSection";
 import { RangeFilter } from "../../filters/RangeFilter";
@@ -19,25 +20,25 @@ export const CATEGORY_FILTER_KEYS = {
 };
 export const CATEGORY_ADMIN_SORT_OPTIONS = [
     { value: "order", label: "Order Asc" },
-    { value: "-order", label: "Order Desc" },
-    { value: "name", label: "Name A-Z" },
-    { value: "-name", label: "Name Z-A" },
+    { value: sortBy("order", "DESC"), label: "Order Desc" },
+    { value: sortBy("name", "ASC"), label: "Name A-Z" },
+    { value: sortBy("name", "DESC"), label: "Name Z-A" },
     { value: "tier", label: "Tier Low to High" },
-    { value: "-tier", label: "Tier High to Low" },
-    { value: "-metrics.totalItemCount", label: "Most Items" },
-    { value: "-createdAt", label: "Newest First" },
+    { value: sortBy("tier", "DESC"), label: "Tier High to Low" },
+    { value: sortBy("metrics.totalItemCount", "DESC"), label: "Most Items" },
+    { value: sortBy("createdAt", "DESC"), label: "Newest First" },
 ];
 export const CATEGORY_SELLER_SORT_OPTIONS = [
     { value: "order", label: "Order Asc" },
-    { value: "name", label: "Name A-Z" },
-    { value: "-name", label: "Name Z-A" },
-    { value: "-metrics.totalItemCount", label: "Most Items" },
+    { value: sortBy("name", "ASC"), label: "Name A-Z" },
+    { value: sortBy("name", "DESC"), label: "Name Z-A" },
+    { value: sortBy("metrics.totalItemCount", "DESC"), label: "Most Items" },
 ];
 export const CATEGORY_PUBLIC_SORT_OPTIONS = [
     { value: "order", label: "Recommended" },
-    { value: "name", label: "Name A-Z" },
-    { value: "-name", label: "Name Z-A" },
-    { value: "-metrics.totalItemCount", label: "Most Items" },
+    { value: sortBy("name", "ASC"), label: "Name A-Z" },
+    { value: sortBy("name", "DESC"), label: "Name Z-A" },
+    { value: sortBy("metrics.totalItemCount", "DESC"), label: "Most Items" },
 ];
 export function getCategoryFilterKeys(variant) {
     return CATEGORY_FILTER_KEYS[variant];

package/dist/features/categories/components/CategoryTree.d.ts

@@ -10,6 +10,6 @@ export interface CategoryTreeProps {
  * CategoryTree — hierarchical expandable navigation for categories.
  *
  * Builds a tree from a flat list by grouping on `rootId` and `parentIds`.
- * Root-level nodes have `tier === 0` or no `parentIds`.
+ * Root-level nodes have sieveFilter("tier", SIEVE_OP.EQ, "= 0") or no `parentIds`.
  */
 export declare function CategoryTree({ categories, activeId, onSelect, className, }: CategoryTreeProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/categories/components/CategoryTree.js

@@ -25,7 +25,7 @@ function CategoryTreeNode({ item, children = [], activeId, onSelect, depth = 0,
  * CategoryTree — hierarchical expandable navigation for categories.
  *
  * Builds a tree from a flat list by grouping on `rootId` and `parentIds`.
- * Root-level nodes have `tier === 0` or no `parentIds`.
+ * Root-level nodes have sieveFilter("tier", SIEVE_OP.EQ, "= 0") or no `parentIds`.
  */
 export function CategoryTree({ categories, activeId, onSelect, className = "", }) {
     // Group children by parent

package/dist/features/categories/hooks/useCategories.d.ts

@@ -4,7 +4,7 @@ interface UseCategoriesListOptions {
     enabled?: boolean;
 }
 export declare function useCategoriesList(opts?: UseCategoriesListOptions): {
-    categories: NoInfer<CategoryItem[]>;
+    categories: CategoryItem[];
     total: number;
     isLoading: boolean;
     error: Error | null;
@@ -37,8 +37,8 @@ interface UseCategoryDetailOptions {
     childrenEndpoint?: string;
 }
 export declare function useCategoryDetail(slug: string, opts?: UseCategoryDetailOptions): {
-    category: NonNullable<NoInfer<CategoryItem | null>> | null;
-    children: NoInfer<CategoryItem[]>;
+    category: CategoryItem | null;
+    children: CategoryItem[];
     isLoading: boolean;
     childrenLoading: boolean;
     error: Error | null;

package/dist/features/categories/hooks/useCategorySelector.d.ts

@@ -8,16 +8,16 @@ export interface UseCategorySelectorOptions {
 export declare function useCategorySelector(options?: UseCategorySelectorOptions): {
     categories: CategoryItem[];
     isLoading: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<CategoryItem[]>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<CategoryItem[], Error>>;
     createCategory: import("@tanstack/react-query").UseMutateFunction<CategoryItem, Error, Record<string, unknown>, unknown>;
     isCreating: boolean;
 };
 export declare function useCategories(options?: {
     endpoint?: string;
 }): {
-    categories: NoInfer<CategoryItem[]>;
+    categories: CategoryItem[];
     isLoading: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<CategoryItem[]>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<CategoryItem[], Error>>;
 };
 export declare function useCreateCategory(options?: {
     endpoint?: string;

package/dist/features/categories/hooks/useCategoryTree.d.ts

@@ -7,7 +7,7 @@ import type { CategoryItem } from "../types";
 export declare function useCategoryTree(opts?: {
     enabled?: boolean;
 }): {
-    categories: NoInfer<CategoryItem[]>;
+    categories: CategoryItem[];
     isLoading: boolean;
 };
 /** Convert category tree to FacetOption[] with indentation prefix for tier > 0. */

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

@@ -36,7 +36,7 @@ export type BundleQueryRule = {
 /**
  * Per-member metadata stored alongside `bundleProductIds`.
  * `drawCount` — only meaningful when the member product has
- * `listingType === "prize-draw"`. Represents how many draw entries
+ * sieveFilter("listingType", SIEVE_OP.EQ, "= "prize-draw""). Represents how many draw entries
  * the buyer receives for that product when they purchase the bundle
  * (e.g. drawCount=5 means 5 raffle entries, not 5 copies of the draw).
  */
@@ -195,7 +195,7 @@ export declare const categoryQueryHelpers: {
     /** @deprecated Use byCategoryType("brand"). */
     readonly brands: () => readonly ["isBrand", "==", true];
     /** SB-UNI B + C + D — discriminator-based listing. */
-    readonly byCategoryType: (type: import("../types").CategoryType) => readonly ["categoryType", "==", import("..").CategoryType];
+    readonly byCategoryType: (type: import("../types").CategoryType) => readonly ["categoryType", "==", import("@mohasinac/appkit").CategoryType];
     readonly sublistings: () => readonly ["categoryType", "==", "sublisting"];
     readonly brandPages: () => readonly ["categoryType", "==", "brand"];
     readonly active: () => readonly ["isActive", "==", true];

package/dist/features/checkout/actions/checkout-actions.d.ts

@@ -25,7 +25,7 @@ export declare function grantCheckoutConsentViaSms(userId: string, userPhone: st
  * `verifiedVia: "admin_bypass"` marker prevents bypass-credit grants.
  *
  * Security: callers MUST verify the requesting user is an admin AND that
- * `siteSettings.featureFlags.adminCheckoutBypass === true` before calling this.
+ * sieveFilter("siteSettings.featureFlags.adminCheckoutBypass", SIEVE_OP.EQ, "= true") before calling this.
  */
 export declare function grantAdminCheckoutBypass(userId: string, addressId: string, bypassingAdminUid: string): Promise<void>;
 export { userRepository };

package/dist/features/checkout/actions/checkout-actions.js

@@ -103,7 +103,7 @@ export async function grantCheckoutConsentViaSms(userId, userPhone, addressId) {
  * `verifiedVia: "admin_bypass"` marker prevents bypass-credit grants.
  *
  * Security: callers MUST verify the requesting user is an admin AND that
- * `siteSettings.featureFlags.adminCheckoutBypass === true` before calling this.
+ * sieveFilter("siteSettings.featureFlags.adminCheckoutBypass", SIEVE_OP.EQ, "= true") before calling this.
  */
 export async function grantAdminCheckoutBypass(userId, addressId, bypassingAdminUid) {
     const address = await findUserAddress(userId, addressId);

package/dist/features/checkout/hooks/useCheckoutApi.d.ts

@@ -62,8 +62,8 @@ interface UseCheckoutOptions<TAddress = any, TCart = any> {
     initialCart?: CartApiResponse<TCart>;
 }
 export declare function useCheckout<TAddress = any, TCart = any>(options?: UseCheckoutOptions<TAddress, TCart>): {
-    addressQuery: import("@tanstack/react-query").UseQueryResult<NoInfer<TAddress[]>, Error>;
-    cartQuery: import("@tanstack/react-query").UseQueryResult<NoInfer<CartApiResponse<TCart>>, Error>;
+    addressQuery: import("@tanstack/react-query").UseQueryResult<TAddress[], Error>;
+    cartQuery: import("@tanstack/react-query").UseQueryResult<CartApiResponse<TCart>, Error>;
     preflightMutation: import("@tanstack/react-query").UseMutationResult<PreflightResponse, Error, string, unknown>;
     placeCodOrderMutation: import("@tanstack/react-query").UseMutationResult<PlaceOrderResponse, Error, PlaceOrderPayload, unknown>;
     createPaymentOrderMutation: import("@tanstack/react-query").UseMutationResult<CreatePaymentOrderResponse, Error, CreatePaymentOrderPayload, unknown>;

package/dist/features/classified/components/ClassifiedListView.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
 import { productRepository } from "../../../repositories";
 import { Container, Heading, Main, Section } from "../../../ui";
 import { AdSlot } from "../../homepage/components/AdSlot";
@@ -16,18 +17,18 @@ function buildClassifiedFilters(params) {
     const minPrice = sp(params, "minPrice");
     const maxPrice = sp(params, "maxPrice");
     if (minPrice)
-        parts.push(`price>=${minPrice}`);
+        parts.push(sieveFilter("price", SIEVE_OP.GTE, minPrice));
     if (maxPrice)
-        parts.push(`price<=${maxPrice}`);
+        parts.push(sieveFilter("price", SIEVE_OP.LTE, maxPrice));
     const city = sp(params, "city");
     if (city)
-        parts.push(`classifiedCity==${city}`);
+        parts.push(sieveFilter("classifiedCity", SIEVE_OP.EQ, city));
     const negotiable = sp(params, "negotiable");
     if (negotiable === "true")
-        parts.push(`classifiedNegotiable==true`);
+        parts.push(sieveFilter("classifiedNegotiable", SIEVE_OP.EQ, "true"));
     const acceptsShipping = sp(params, "acceptsShipping");
     if (acceptsShipping === "true")
-        parts.push(`classifiedAcceptsShipping==true`);
+        parts.push(sieveFilter("classifiedAcceptsShipping", SIEVE_OP.EQ, "true"));
     return parts.join(",");
 }
 export async function ClassifiedListView({ searchParams = {} }) {