@mohasinac/appkit 2.8.3 → 2.8.4

package/dist/features/layout/BottomActionsContext.js

@@ -1,41 +1,5 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
-/**
- * BottomActionsContext
- *
- * Provides a context for registering page-level mobile action bars.
- * Features call `useBottomActions` to push actions; the `<BottomActions>`
- * layout component reads this context and renders the bar above BottomNavbar.
- *
- * Supports two modes:
- *  - Page mode: primary page actions (Add to Cart, Buy Now, Place Bid, etc.)
- *  - Bulk mode: activated when `bulk.selectedCount > 0` — shows selection
- *    count + custom bulk action buttons (Delete, Archive, Export, etc.)
- *
- * @example — product detail page
- * ```tsx
- * useBottomActions({
- *   actions: [
- *     { id: "wishlist", icon: <Heart className="w-4 h-4" />, label: t("wishlist"), variant: "ghost", grow: false, onClick: handleWishlist },
- *     { id: "cart",    label: t("addToCart"), variant: "outline", onClick: handleAddToCart },
- *     { id: "buy",     label: t("buyNow"),    variant: "primary", onClick: handleBuyNow },
- *   ],
- * });
- * ```
- *
- * @example — admin listing with bulk select
- * ```tsx
- * useBottomActions({
- *   bulk: {
- *     selectedCount: selectedIds.length,
- *     onClearSelection: () => setSelectedIds([]),
- *     actions: [
- *       { id: "delete", label: t("bulkDelete", { count: selectedIds.length }), variant: "danger", onClick: handleBulkDelete },
- *     ],
- *   },
- * });
- * ```
- */
 import { createContext, useCallback, useContext, useMemo, useRef, useState, } from "react";
 const EMPTY = { actions: [] };
 const BottomActionsContext = createContext(null);

package/dist/features/live/components/LiveItemsListView.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 buildLiveFilters(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 species = sp(params, "species");
     if (species)
-        parts.push(`liveSpecies==${species}`);
+        parts.push(sieveFilter("liveSpecies", SIEVE_OP.EQ, species));
     const liveSex = sp(params, "liveSex");
     if (liveSex)
-        parts.push(`liveSex==${liveSex}`);
+        parts.push(sieveFilter("liveSex", SIEVE_OP.EQ, liveSex));
     const transport = sp(params, "liveTransportMethod");
     if (transport)
-        parts.push(`liveTransportMethod==${transport}`);
+        parts.push(sieveFilter("liveTransportMethod", SIEVE_OP.EQ, transport));
     return parts.join(",");
 }
 export async function LiveItemsListView({ searchParams = {} }) {

package/dist/features/loyalty/hooks/useLoyaltyBalance.d.ts

@@ -1,4 +1,4 @@
 import type { LoyaltyBalance } from "../types";
 export declare function useLoyaltyBalance(uid: string | undefined, opts?: {
     endpoint?: string;
-}): import("@tanstack/react-query").UseQueryResult<NoInfer<LoyaltyBalance | null>, Error>;
+}): import("@tanstack/react-query").UseQueryResult<LoyaltyBalance | null, Error>;

package/dist/features/orders/hooks/useOrders.d.ts

@@ -17,7 +17,7 @@ export declare function useOrder(id: string, opts?: {
     enabled?: boolean;
     endpoint?: string;
 }): {
-    order: NoInfer<Order> | undefined;
+    order: Order | undefined;
     isLoading: boolean;
     error: Error | null;
 };
@@ -25,7 +25,7 @@ export declare function useTrackOrder(trackingId: string | null | undefined, opt
     enabled?: boolean;
     endpoint?: string;
 }): {
-    trackingInfo: NonNullable<NoInfer<TrackingInfo | null>> | null;
+    trackingInfo: TrackingInfo | null;
     isLoading: boolean;
     error: Error | null;
 };

package/dist/features/payments/hooks/usePayments.d.ts

@@ -4,7 +4,7 @@ export declare function usePaymentSettings(opts?: {
     enabled?: boolean;
     endpoint?: string;
 }): {
-    settings: NoInfer<PaymentSettings> | undefined;
+    settings: PaymentSettings | undefined;
     isLoading: boolean;
     error: Error | null;
 };

package/dist/features/pre-orders/components/PreOrdersListView.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, Main, Heading, Section } from "../../../ui";
 import { AdSlot } from "../../homepage/components/AdSlot";
@@ -16,15 +17,15 @@ function buildPreOrderFilters(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 store = sp(params, "storeId");
     if (store)
-        parts.push(`storeId==${store}`);
+        parts.push(sieveFilter("storeId", SIEVE_OP.EQ, store));
     const preOrderProductionStatus = sp(params, "preOrderProductionStatus");
     if (preOrderProductionStatus)
-        parts.push(`preOrderProductionStatus==${preOrderProductionStatus}`);
+        parts.push(sieveFilter("preOrderProductionStatus", SIEVE_OP.EQ, preOrderProductionStatus));
     return parts.join(",");
 }
 export async function PreOrdersListView({ searchParams = {} }) {

package/dist/features/pre-orders/hooks/usePreOrders.d.ts

@@ -1,7 +1,7 @@
 import type { PreorderItem } from "../types";
 export declare function usePreorders(opts?: {
     endpoint?: string;
-}): import("@tanstack/react-query").UseQueryResult<NoInfer<PreorderItem[]>, Error>;
+}): import("@tanstack/react-query").UseQueryResult<PreorderItem[], Error>;
 export declare function usePreorder(slug: string | undefined, opts?: {
     endpoint?: string;
-}): import("@tanstack/react-query").UseQueryResult<NoInfer<PreorderItem | null>, Error>;
+}): import("@tanstack/react-query").UseQueryResult<PreorderItem | null, Error>;

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

@@ -1,23 +1,25 @@
+import { sieveAnd, sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
+import { sortBy } from "@mohasinac/appkit";
 import { productRepository } from "../repository/products.repository";
 import { ProductStatusValues } from "../schemas";
 /**
  * Reusable Sieve clauses. Single source of truth for the listing-type
  * discriminator across every action helper in this file. SB1-G (S21 2026-05-12)
- * routes everything through `listingType==X` — the legacy boolean flags are
+ * routes everything through sieveFilter("listingType", SIEVE_OP.EQ, "X") — the legacy boolean flags are
  * never emitted by code under our control any more.
  */
-const PUBLISHED_CLAUSE = "status==published";
-const AUCTIONS_PUBLISHED = `listingType==auction,${PUBLISHED_CLAUSE}`;
-const PREORDERS_PUBLISHED = `listingType==pre-order,${PUBLISHED_CLAUSE}`;
+const PUBLISHED_CLAUSE = sieveFilter("status", SIEVE_OP.EQ, "published");
+const AUCTIONS_PUBLISHED = sieveAnd(sieveFilter("listingType", SIEVE_OP.EQ, "auction"), PUBLISHED_CLAUSE);
+const PREORDERS_PUBLISHED = sieveAnd(sieveFilter("listingType", SIEVE_OP.EQ, "pre-order"), PUBLISHED_CLAUSE);
 export async function listProducts(params = {}) {
     const { filters, sorts = "-createdAt", page = 1, pageSize = 20, listingType, featured, storeId, categoriesIn, } = params;
     const compoundFilters = [];
     if (listingType)
-        compoundFilters.push(`listingType==${listingType}`);
+        compoundFilters.push(sieveFilter("listingType", SIEVE_OP.EQ, listingType));
     if (featured === true)
         compoundFilters.push("featured==true");
     if (storeId)
-        compoundFilters.push(`storeId==${storeId}`);
+        compoundFilters.push(sieveFilter("storeId", SIEVE_OP.EQ, storeId));
     if (filters)
         compoundFilters.push(filters);
     const mergedFilters = compoundFilters.length > 0 ? compoundFilters.join(",") : undefined;
@@ -34,8 +36,8 @@ export async function getProductById(id) {
 }
 export async function getFeaturedProducts(pageSize = 8) {
     return productRepository.list({
-        filters: `featured==true,${PUBLISHED_CLAUSE}`,
-        sorts: "-createdAt",
+        filters: sieveAnd(sieveFilter("featured", SIEVE_OP.EQ, "true"), PUBLISHED_CLAUSE),
+        sorts: sortBy("createdAt", "DESC"),
         page: 1,
         pageSize,
     });
@@ -43,7 +45,7 @@ export async function getFeaturedProducts(pageSize = 8) {
 export async function getFeaturedAuctions(pageSize = 6) {
     return productRepository.list({
         filters: AUCTIONS_PUBLISHED,
-        sorts: "auctionEndDate",
+        sorts: sortBy("auctionEndDate", "ASC"),
         page: 1,
         pageSize,
     });
@@ -51,7 +53,7 @@ export async function getFeaturedAuctions(pageSize = 6) {
 export async function getLatestProducts(pageSize = 12) {
     return productRepository.list({
         filters: PUBLISHED_CLAUSE,
-        sorts: "-createdAt",
+        sorts: sortBy("createdAt", "DESC"),
         page: 1,
         pageSize,
     });
@@ -59,7 +61,7 @@ export async function getLatestProducts(pageSize = 12) {
 export async function getLatestAuctions(pageSize = 12) {
     return productRepository.list({
         filters: AUCTIONS_PUBLISHED,
-        sorts: "-createdAt",
+        sorts: sortBy("createdAt", "DESC"),
         page: 1,
         pageSize,
     });
@@ -76,7 +78,7 @@ export async function listAuctions(params = {}) {
 export async function getFeaturedPreOrders(pageSize = 6) {
     return productRepository.list({
         filters: PREORDERS_PUBLISHED,
-        sorts: "preOrderDeliveryDate",
+        sorts: sortBy("preOrderDeliveryDate", "ASC"),
         page: 1,
         pageSize,
     });
@@ -84,7 +86,7 @@ export async function getFeaturedPreOrders(pageSize = 6) {
 export async function getLatestPreOrders(pageSize = 12) {
     return productRepository.list({
         filters: PREORDERS_PUBLISHED,
-        sorts: "-createdAt",
+        sorts: sortBy("createdAt", "DESC"),
         page: 1,
         pageSize,
     });
@@ -100,8 +102,8 @@ export async function listPreOrders(params = {}) {
 }
 export async function getRelatedProducts(categoryId, excludeId, limit = 6) {
     const result = await productRepository.list({
-        filters: `categoryId==${categoryId},${PUBLISHED_CLAUSE}`,
-        sorts: "-createdAt",
+        filters: sieveAnd(sieveFilter("categoryId", SIEVE_OP.EQ, categoryId), PUBLISHED_CLAUSE),
+        sorts: sortBy("createdAt", "DESC"),
         page: 1,
         pageSize: limit + 1,
     });

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

@@ -17,7 +17,7 @@ export type ProductSortValue = (typeof PRODUCT_SORT_VALUES)[keyof typeof PRODUCT
  * Default admin column definitions for a product table.
  * These are plain data — no React imports, no JSX.
  *
- * Use with `DataTable<T>` from `@mohasinac/feat-admin`.
+ * Use with sieveFilter("DataTable", SIEVE_OP.LT, "T>") from `@mohasinac/feat-admin`.
  *
  * @example — consumer app overrides/extends columns
  * ```ts

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

@@ -14,7 +14,7 @@ export const PRODUCT_SORT_VALUES = {
  * Default admin column definitions for a product table.
  * These are plain data — no React imports, no JSX.
  *
- * Use with `DataTable<T>` from `@mohasinac/feat-admin`.
+ * Use with sieveFilter("DataTable", SIEVE_OP.LT, "T>") from `@mohasinac/feat-admin`.
  *
  * @example — consumer app overrides/extends columns
  * ```ts

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

@@ -1,19 +1,5 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-/**
- * PrizeDrawCollage (SB4-B)
- *
- * Read-only display of a prize-draw's full prize pool. Each cell shows the
- * primary image, item-number badge, and title. Items with `isWon === true`
- * are dimmed under a diagonal overlay with a "Won" label so the public
- * collage truthfully reflects what's still up for grabs.
- *
- * Clicking any cell opens a full-screen lightbox starting at that item and
- * cycling circularly through all items in itemNumber order.
- *
- * Optional `highlightItemNumber` (passed by the reveal modal during animation)
- * adds an emphasis ring to the cell that just won.
- */
 import { useState } from "react";
 import { Div, Text } from "../../../ui";
 import { ImageLightbox } from "../../../ui/components/ImageLightbox";

package/dist/features/products/components/PrizeDrawsListingView.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, Main, Heading, Section, Text } from "../../../ui";
 import { AdSlot } from "../../homepage/components/AdSlot";
@@ -16,15 +17,15 @@ function buildPrizeDrawFilters(params) {
     const minPrice = sp(params, "minPrice");
     const maxPrice = sp(params, "maxPrice");
     if (minPrice)
-        parts.push(`pricePerEntry>=${minPrice}`);
+        parts.push(sieveFilter("pricePerEntry", SIEVE_OP.GTE, minPrice));
     if (maxPrice)
-        parts.push(`pricePerEntry<=${maxPrice}`);
+        parts.push(sieveFilter("pricePerEntry", SIEVE_OP.LTE, maxPrice));
     const store = sp(params, "storeId");
     if (store)
-        parts.push(`storeId==${store}`);
+        parts.push(sieveFilter("storeId", SIEVE_OP.EQ, store));
     const status = sp(params, "prizeRevealStatus");
     if (status)
-        parts.push(`prizeRevealStatus==${status}`);
+        parts.push(sieveFilter("prizeRevealStatus", SIEVE_OP.EQ, status));
     return parts.join(",");
 }
 /**

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

@@ -1,4 +1,6 @@
 import { jsx as _jsx, 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 { Container, Div, Heading, Section, Stack, Text, } from "../../../ui";
 import { ROUTES } from "../../../next";
@@ -15,8 +17,8 @@ export async function PrizeDrawsSection({ config, }) {
     let draws = [];
     try {
         const result = await productRepository.list({
-            filters: "listingType==prize-draw,status==published",
-            sorts: "-createdAt",
+            filters: sieveAnd(sieveFilter("listingType", SIEVE_OP.EQ, "prize-draw"), sieveFilter("status", SIEVE_OP.EQ, "published")),
+            sorts: sortBy("createdAt", "DESC"),
             pageSize: limit,
         });
         draws = (result.items ?? []);

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

@@ -154,10 +154,10 @@ export declare const BUNDLE_SORT_OPTIONS: readonly [...({
     readonly value: string;
     readonly label: "Price: High to Low";
 }, {
-    readonly value: "-savingsAmount";
+    readonly value: string;
     readonly label: "Most Savings";
 }, {
-    readonly value: "-bundleItemCount";
+    readonly value: string;
     readonly label: "Most Items";
 }];
 export declare const PRIZE_DRAW_SORT_OPTIONS: readonly [{

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

@@ -79,8 +79,8 @@ export const PREORDER_SORT_OPTIONS = [
 export const BUNDLE_SORT_OPTIONS = [
     ...BASE_TIME_SORTS.slice(0, 1), // Newest First
     ...BASE_PRICE_SORTS,
-    { value: "-savingsAmount", label: "Most Savings" },
-    { value: "-bundleItemCount", label: "Most Items" },
+    { value: sortBy("savingsAmount", "DESC"), label: "Most Savings" },
+    { value: sortBy("bundleItemCount", "DESC"), label: "Most Items" },
 ];
 // ---------------------------------------------------------------------------
 // Prize Draws

package/dist/features/products/hooks/useProductDetail.d.ts

@@ -10,6 +10,6 @@ export declare function useProductDetail<TProduct = ProductItem>(slug: string, o
     product: TProduct | null;
     isLoading: boolean;
     error: Error | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<ProductItem | null>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<ProductItem | null, Error>>;
 };
 export {};

package/dist/features/products/hooks/useRelatedProducts.d.ts

@@ -4,4 +4,4 @@ import type { ProductListResponse } from "../types";
  * boolean translates to the canonical `listingType` clause; new callers can
  * pass the union directly via the same parameter slot in a follow-up.
  */
-export declare function useRelatedProducts(category: string, excludeId: string, limit?: number, isAuction?: boolean): import("@tanstack/react-query").UseQueryResult<NoInfer<ProductListResponse>, Error>;
+export declare function useRelatedProducts(category: string, excludeId: string, limit?: number, isAuction?: boolean): import("@tanstack/react-query").UseQueryResult<ProductListResponse, Error>;

package/dist/features/products/hooks/useRelatedProducts.js

@@ -1,3 +1,4 @@
+import { sieveAnd, sieveFilter, SIEVE_OP, sortBy } from "@mohasinac/appkit";
 import { useQuery } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { PRODUCT_ENDPOINTS } from "../../../constants/api-endpoints";
@@ -8,11 +9,11 @@ import { PRODUCT_ENDPOINTS } from "../../../constants/api-endpoints";
  */
 export function useRelatedProducts(category, excludeId, limit = 8, isAuction = false) {
     const listingTypeClause = isAuction
-        ? "listingType==auction"
-        : "listingType==standard";
+        ? sieveFilter("listingType", SIEVE_OP.EQ, "auction")
+        : sieveFilter("listingType", SIEVE_OP.EQ, "standard");
     const params = new URLSearchParams({
-        filters: `status==published,category==${encodeURIComponent(category)},${listingTypeClause}`,
-        sorts: "-createdAt",
+        filters: sieveAnd(sieveFilter("status", SIEVE_OP.EQ, "published"), sieveFilter("category", SIEVE_OP.EQ, encodeURIComponent(category)), listingTypeClause),
+        sorts: sortBy("createdAt", "DESC"),
         pageSize: String(limit),
     });
     return useQuery({

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

@@ -9,13 +9,13 @@ export declare function usePromotions(params?: PromotionsListParams, opts?: {
     hasMore: boolean;
     isLoading: boolean;
     error: string | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<PromotionsListResponse>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<PromotionsListResponse, Error>>;
 };
 export declare function useCoupon(code: string, opts?: {
     enabled?: boolean;
     endpoint?: string;
 }): {
-    coupon: NonNullable<NoInfer<CouponItem | null>> | null;
+    coupon: CouponItem | null;
     isLoading: boolean;
     error: string | null;
 };

package/dist/features/reviews/actions/review-actions.js

@@ -4,6 +4,7 @@
  * Pure business functions for review create/update/delete/vote and query flows.
  * Auth and rate-limit stay in consumer server-action wrappers.
  */
+import { sortBy } from "@mohasinac/appkit";
 import { AuthorizationError, NotFoundError, ValidationError, } from "../../../errors";
 import { serverLogger } from "../../../monitoring";
 import { maskPublicReview } from "../../../security";
@@ -144,7 +145,7 @@ export async function voteReviewHelpful(reviewId, helpful) {
 }
 export async function listReviewsByProduct(productId, page = 1, pageSize = 10) {
     const result = await reviewRepository.listForProduct(productId, {
-        sorts: "-createdAt",
+        sorts: sortBy("createdAt", "DESC"),
         page,
         pageSize,
     });

package/dist/features/reviews/components/ReviewsIndexPageView.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
 import { reviewRepository } from "../../../repositories";
 import { Container, Heading, Main, Section } from "../../../ui";
 import { AdSlot } from "../../homepage/components/AdSlot";
@@ -13,22 +14,22 @@ function buildReviewFilters(params) {
     if (rating) {
         const values = rating.split("|").filter(Boolean);
         if (values.length === 1)
-            parts.push(`rating==${values[0]}`);
+            parts.push(sieveFilter("rating", SIEVE_OP.EQ, values[0]));
         else if (values.length > 1)
-            parts.push(`rating==${values.join("|")}`);
+            parts.push(sieveFilter("rating", SIEVE_OP.EQ, values.join("|")));
     }
     const minVotes = sp(params, "minVotes");
     if (minVotes)
-        parts.push(`helpfulCount>=${minVotes}`);
+        parts.push(sieveFilter("helpfulCount", SIEVE_OP.GTE, minVotes));
     const maxVotes = sp(params, "maxVotes");
     if (maxVotes)
-        parts.push(`helpfulCount<=${maxVotes}`);
+        parts.push(sieveFilter("helpfulCount", SIEVE_OP.LTE, maxVotes));
     const dateFrom = sp(params, "dateFrom");
     const dateTo = sp(params, "dateTo");
     if (dateFrom)
-        parts.push(`createdAt>=${dateFrom}`);
+        parts.push(sieveFilter("createdAt", SIEVE_OP.GTE, dateFrom));
     if (dateTo)
-        parts.push(`createdAt<=${dateTo}`);
+        parts.push(sieveFilter("createdAt", SIEVE_OP.LTE, dateTo));
     const q = sp(params, "q");
     if (q)
         parts.push(`productTitle@=*${q}`);

package/dist/features/reviews/hooks/useReviews.d.ts

@@ -14,7 +14,7 @@ export declare function useReviews(params?: ReviewListParams, opts?: UseReviewsO
     ratingDistribution: Record<number, number> | undefined;
     isLoading: boolean;
     error: Error | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<ReviewListResponse>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<ReviewListResponse, Error>>;
 };
 interface UseProductReviewsOptions {
     page?: number;
@@ -30,6 +30,6 @@ export declare function useProductReviews(productId: string, opts?: UseProductRe
     ratingDistribution: Record<number, number> | undefined;
     isLoading: boolean;
     error: Error | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<ReviewListResponse>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<ReviewListResponse, Error>>;
 };
 export {};

package/dist/features/scams/actions/scam-actions.js

@@ -1,4 +1,5 @@
 "use server";
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
 import { scammerRepository } from "../repository/scammer.repository";
 /**
  * List verified scammer profiles for the public registry page.
@@ -12,9 +13,9 @@ export async function listVerifiedScammers(searchParams) {
     // scamType / scamPlatform filter chips — status==verified is enforced by the base query
     const filters = [];
     if (params.scamType)
-        filters.push(`scamType==${params.scamType}`);
+        filters.push(sieveFilter("scamType", SIEVE_OP.EQ, String(params.scamType)));
     if (params.scamPlatform)
-        filters.push(`scamPlatform==${params.scamPlatform}`);
+        filters.push(sieveFilter("scamPlatform", SIEVE_OP.EQ, String(params.scamPlatform)));
     const result = await scammerRepository.listVerified({
         filters: filters.join(",") || undefined,
         sorts: sort,

package/dist/features/scams/components/ScamRegistryView.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { sortBy } from "@mohasinac/appkit";
 import Link from "next/link";
 import { ROUTES } from "../../../next/routing/route-map";
 const CLS_ICON_SM = "h-3 w-3 shrink-0";
@@ -10,10 +11,10 @@ import { listVerifiedScammers } from "../actions/scam-actions";
 import { SCAM_PLATFORM_LABELS } from "../schemas/firestore";
 import { SCAM_TYPES, SCAM_TYPE_LABELS } from "../constants/scam-types";
 const SORT_OPTIONS = [
-    { value: "-createdAt", label: "Newest Reports" },
-    { value: "createdAt", label: "Oldest Reports" },
-    { value: "-incidentCount", label: "Most Victims" },
-    { value: "-amountLost", label: "Highest Loss" },
+    { value: sortBy("createdAt", "DESC"), label: "Newest Reports" },
+    { value: sortBy("createdAt", "ASC"), label: "Oldest Reports" },
+    { value: sortBy("incidentCount", "DESC"), label: "Most Victims" },
+    { value: sortBy("amountLost", "DESC"), label: "Highest Loss" },
 ];
 function sp(params, key) {
     const v = params[key];

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

@@ -4,6 +4,7 @@
  * Pure business functions — auth, rate-limiting, and Next.js specifics
  * are handled by the calling server action in the consumer.
  */
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
 import { productRepository } from "../../products/repository/products.repository";
 import { serverLogger } from "../../../monitoring";
 /**
@@ -14,18 +15,18 @@ export async function searchProducts(query = {}) {
     const { q = "", category, subcategory, minPrice = 0, maxPrice = 0, condition, listingType, sort = "-createdAt", page = 1, pageSize = 20, } = query;
     const filterParts = ["status==published"];
     if (category)
-        filterParts.push(`category==${category}`);
+        filterParts.push(sieveFilter("category", SIEVE_OP.EQ, category));
     if (subcategory)
-        filterParts.push(`subcategory==${subcategory}`);
+        filterParts.push(sieveFilter("subcategory", SIEVE_OP.EQ, subcategory));
     if (minPrice > 0)
-        filterParts.push(`price>=${minPrice}`);
+        filterParts.push(sieveFilter("price", SIEVE_OP.GTE, minPrice));
     if (maxPrice > 0 && maxPrice >= minPrice)
-        filterParts.push(`price<=${maxPrice}`);
+        filterParts.push(sieveFilter("price", SIEVE_OP.LTE, maxPrice));
     if (condition)
-        filterParts.push(`condition==${condition}`);
+        filterParts.push(sieveFilter("condition", SIEVE_OP.EQ, condition));
     // SB1-G Phase 4 — canonical listingType discriminator.
     if (listingType)
-        filterParts.push(`listingType==${listingType}`);
+        filterParts.push(sieveFilter("listingType", SIEVE_OP.EQ, listingType));
     if (q.trim())
         filterParts.push(`title_=${q.trim()}`);
     const sieveResult = await productRepository.list({

package/dist/features/search/hooks/useSearch.d.ts

@@ -11,11 +11,11 @@ interface UseSearchOptions {
  * `options.initialCategories` — server-prefetched category list for filter facets.
  */
 export declare function useSearch(searchParams: string, options?: UseSearchOptions): {
-    results: NoInfer<SearchResponse> | null;
+    results: SearchResponse | null;
     items: import("..").SearchProductItem[];
     total: number;
     totalPages: number;
     isLoading: boolean;
-    categories: NoInfer<SearchCategoryOption[]>;
+    categories: SearchCategoryOption[];
 };
 export {};

package/dist/features/seller/components/CouponInlineSelect.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
+import { sortBy } from "@mohasinac/appkit";
 import React from "react";
 import { PaginatedSelect } from "../../../ui/components/PaginatedSelect";
 import { apiClient } from "../../../http";
@@ -10,7 +11,7 @@ function makeLoader(scope) {
         const params = new URLSearchParams({
             page: String(page),
             pageSize: "25",
-            sorts: "-createdAt",
+            sorts: sortBy("createdAt", "DESC"),
         });
         if (query.trim())
             params.set("q", query.trim());

package/dist/features/seller/components/SellerAuctionsView.js

@@ -1,5 +1,7 @@
 "use client";
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
+import { sortBy } from "@mohasinac/appkit";
 import React, { useState, useCallback } from "react";
 import { useEntityDelete } from "../../../react/hooks/useEntityDelete";
 import { ConfirmDeleteModal, FilterChipGroup, ListingLayout, RowActionMenu } from "../../../ui";
@@ -36,14 +38,14 @@ export function SellerAuctionsView({ children, onEditClick, onDelete, onBulkDele
         searchPlaceholder: "Search auctions by product name",
         emptyLabel: "No auctions found",
         filterKeys: ["status"],
-        defaultSort: "endsAt",
+        defaultSort: sortBy("endsAt", "ASC"),
         queryKey: ["seller", "auctions", "listing"],
         endpoint: SELLER_ENDPOINTS.AUCTIONS,
         sortOptions: [
             { value: "endsAt", label: "Ending soon" },
-            { value: "-endsAt", label: "Ending latest" },
-            { value: "-createdAt", label: "Newest" },
-            { value: "createdAt", label: "Oldest" },
+            { value: sortBy("endsAt", "DESC"), label: "Ending latest" },
+            { value: sortBy("createdAt", "DESC"), label: "Newest" },
+            { value: sortBy("createdAt", "ASC"), label: "Oldest" },
         ],
         mapRows: (response) => toRecordArray(response.auctions).map((item, index) => ({
             id: toStringValue(item.id, `auction-${index}`),
@@ -58,7 +60,7 @@ export function SellerAuctionsView({ children, onEditClick, onDelete, onBulkDele
         getTotal: (response, mappedRows) => typeof response.meta?.total === "number"
             ? response.meta.total
             : mappedRows.length,
-        buildFilters: (state) => state.status && state.status !== "All" ? `status==${state.status}` : undefined,
+        buildFilters: (state) => state.status && state.status !== "All" ? sieveFilter("status", SIEVE_OP.EQ, state.status) : undefined,
         buildBulkActions: onBulkDelete
             ? (selection) => [
                 {