@mohasinac/appkit 2.8.3 → 2.8.5

package/dist/_internal/client/features/layout/SidebarCollapseToggle.js

@@ -9,7 +9,9 @@ const CHEVRON_STYLE = {
 export function SidebarCollapseToggle({ expanded, onToggle, expandedLabel = "Collapse sidebar", collapsedLabel = "Expand sidebar", }) {
     return (_jsx("button", { type: "button", onClick: onToggle, "aria-label": expanded ? expandedLabel : collapsedLabel, "aria-expanded": expanded, 
         // eslint-disable-next-line lir/no-inline-static-style
+        // audit-inline-style-ok: pass-through style prop
         style: HANDLE_STYLE, className: "w-9 shrink-0 flex items-center justify-center cursor-pointer rounded-r-[1.25rem] shadow-lg transition-all duration-200 hover:shadow-xl hover:brightness-110 active:scale-[0.96]", children: _jsx("svg", { className: `w-4 h-4 drop-shadow-sm transition-transform duration-300 ${expanded ? "" : "rotate-180"}`, 
             // eslint-disable-next-line lir/no-inline-static-style
+            // audit-inline-style-ok: pass-through style prop
             style: CHEVRON_STYLE, fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2.5, d: "M15 19l-7-7 7-7" }) }) }));
 }

package/dist/_internal/shared/listing-types/action-tracker.js

@@ -20,7 +20,6 @@ function defaultSink(event) {
     if (typeof window === "undefined") {
         // SSR / Node — best-effort console log; production servers can swap
         // the sink to a real logger via `setActionTrackerSink`.
-        // eslint-disable-next-line no-console
         if (process.env.NODE_ENV !== "production") {
             console.debug("[action-tracker]", event);
         }
@@ -30,7 +29,6 @@ function defaultSink(event) {
     // deployed; for now stay silent in prod to avoid 404 noise + dev-mode
     // logs surface the events.
     if (process.env.NODE_ENV !== "production") {
-        // eslint-disable-next-line no-console
         console.debug("[action-tracker]", event);
     }
 }

package/dist/client.d.ts

@@ -62,6 +62,8 @@ export type { UseBulkSelectionOptions, UseBulkSelectionReturn } from "./react/ho
 export { useEntityDelete } from "./react/hooks/useEntityDelete";
 export type { UseEntityDeleteOptions, UseEntityDeleteReturn } from "./react/hooks/useEntityDelete";
 export { ROUTES, PUBLIC_ROUTES, PROTECTED_ROUTES, AUTH_ROUTES } from "./constants/index";
+export { SORT_DIR, sortBy } from "./constants/sort";
+export { SIEVE_OP, sieveFilter, sieveAnd, sieveMultiEq } from "./utils/sieve-builder";
 export { Container, Grid, Row, Stack } from "./ui/components/Layout";
 export { Div } from "./ui/components/Div";
 export { Main, Section, Nav, Ul, Ol, Li, Table, Thead, Tbody, Tr, Th, Td } from "./ui/components/Semantic";

package/dist/client.js

@@ -125,6 +125,8 @@ export { useBulkSelection } from "./react/hooks/useBulkSelection";
 export { useEntityDelete } from "./react/hooks/useEntityDelete";
 // Client-safe constants, UI primitives, and views
 export { ROUTES, PUBLIC_ROUTES, PROTECTED_ROUTES, AUTH_ROUTES } from "./constants/index";
+export { SORT_DIR, sortBy } from "./constants/sort";
+export { SIEVE_OP, sieveFilter, sieveAnd, sieveMultiEq } from "./utils/sieve-builder";
 export { Container, Grid, Row, Stack } from "./ui/components/Layout";
 export { Div } from "./ui/components/Div";
 export { Main, Section, Nav, Ul, Ol, Li, Table, Thead, Tbody, Tr, Th, Td } from "./ui/components/Semantic";

package/dist/core/hooks/useSiteSettings.d.ts

@@ -1 +1 @@
-export declare function useSiteSettings<T = unknown>(endpoint?: "/api/site-settings", staleTime?: number): import("@tanstack/react-query").UseQueryResult<NoInfer<T>, Error>;
+export declare function useSiteSettings<T = unknown>(endpoint?: "/api/site-settings", staleTime?: number): import("@tanstack/react-query").UseQueryResult<import("@tanstack/query-core").NoInfer<T>, Error>;

package/dist/core/unit-of-work.js

@@ -1,4 +1,3 @@
-// eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-require-imports
 const getAdminDb = () => module.require("../providers/db-firebase").getAdminDb();
 import { DatabaseError } from "../errors";
 import { serverLogger } from "../monitoring";

package/dist/features/account/components/NotificationBell.js

@@ -50,6 +50,7 @@ export function NotificationBell({ limit = 10, viewAllHref, labels, icons, rende
     const emitSuccess = onMarkAllReadSuccess ?? showSuccess;
     const emitError = onMarkAllReadError ?? showError;
     const handleMarkAllRead = useCallback(async () => {
+        // toast-intentionally-silent — uses emitError(labels.error) callback for feedback
         try {
             await markAllRead(undefined);
             refetch();

package/dist/features/account/components/UserOffersPanel.js

@@ -65,6 +65,7 @@ export function UserOffersPanel({ fetchEndpoint = "/api/user/offers", onAcceptCo
     const [fetchError, setFetchError] = useState("");
     const [showLoginModal, setShowLoginModal] = useState(false);
     const loadOffers = useCallback(async () => {
+        // toast-intentionally-silent — error rendered inline via setFetchError()
         setLoading(true);
         setFetchError("");
         try {

package/dist/features/account/components/UserSidebar.js

@@ -77,7 +77,9 @@ export function UserSidebar({ items, groups, mobileOpen = false, onCloseMobile,
     // ── Persistent sidebar variant (desktop left slide-over, mobile bottom-sheet) ──────
     if (variant === "sidebar") {
         const handleToggle = onToggle ?? close;
-        return (_jsxs(_Fragment, { children: [desktopOpen && (_jsx(Div, { className: "hidden md:block fixed inset-0 bg-black/40 backdrop-blur-[2px] z-30", onClick: handleToggle, "aria-hidden": "true" })), _jsxs(Div, { className: "hidden md:flex fixed left-0 z-40 transition-transform duration-300", style: {
+        return (_jsxs(_Fragment, { children: [desktopOpen && (_jsx(Div, { className: "hidden md:block fixed inset-0 bg-black/40 backdrop-blur-[2px] z-30", onClick: handleToggle, "aria-hidden": "true" })), _jsxs(Div, { className: "hidden md:flex fixed left-0 z-40 transition-transform duration-300", 
+                    // audit-inline-style-ok: dynamic CSS
+                    style: {
                         top: "var(--header-height, 3.5rem)",
                         height: "calc(100vh - var(--header-height, 3.5rem))",
                         width: "13rem",

package/dist/features/account/hooks/useAccount.d.ts

@@ -5,9 +5,9 @@ interface UseProfileOptions {
     endpoint?: string;
 }
 export declare function useProfile(userId: string, opts?: UseProfileOptions): {
-    profile: NoInfer<UserProfile> | undefined;
+    profile: UserProfile | undefined;
     isLoading: boolean;
     error: Error | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<UserProfile>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<UserProfile, Error>>;
 };
 export {};

package/dist/features/account/hooks/useAddressSelector.d.ts

@@ -18,7 +18,7 @@ export declare function useAddressSelector(options?: {
 }): {
     addresses: SavedAddress[];
     isLoading: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<SavedAddress[]>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<SavedAddress[], Error>>;
     createAddress: import("@tanstack/react-query").UseMutateFunction<CreateAddressApiResponse, Error, AddressFormData, unknown>;
     isSaving: boolean;
 };

package/dist/features/account/hooks/useAddresses.d.ts

@@ -36,11 +36,11 @@ export declare function useAddresses(options?: {
     enabled?: boolean;
     listEndpoint?: string;
     filters?: AddressFilterParams;
-}): import("@tanstack/react-query").UseQueryResult<NoInfer<Address[]>, Error>;
+}): import("@tanstack/react-query").UseQueryResult<Address[], Error>;
 export declare function useAddress(id: string, options?: {
     enabled?: boolean;
     byIdEndpoint?: (id: string) => string;
-}): import("@tanstack/react-query").UseQueryResult<NoInfer<Address>, Error>;
+}): import("@tanstack/react-query").UseQueryResult<Address, Error>;
 export declare function useCreateAddress(options?: {
     listEndpoint?: string;
     onSuccess?: (data: Address) => void;

package/dist/features/account/hooks/useNotifications.d.ts

@@ -16,7 +16,7 @@ export declare function useNotifications<TNotification = any>(limit?: number, op
     notifications: TNotification[];
     unreadCount: number;
     isLoading: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<NotificationsResponse<TNotification>>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NotificationsResponse<TNotification>, Error>>;
     markRead: import("@tanstack/react-query").UseMutateFunction<unknown, Error, string, unknown>;
     markAllRead: import("@tanstack/react-query").UseMutateFunction<unknown, Error, void, unknown>;
     isMarkingAll: boolean;

package/dist/features/account/hooks/useProfile.d.ts

@@ -19,7 +19,7 @@ export interface UpdateCurrentProfileInput {
 export declare function useCurrentProfile(options?: {
     enabled?: boolean;
     endpoint?: string;
-}): import("@tanstack/react-query").UseQueryResult<NoInfer<UserProfile>, Error>;
+}): import("@tanstack/react-query").UseQueryResult<UserProfile, Error>;
 export declare function useUpdateCurrentProfile(options?: {
     onSuccess?: (data: unknown) => void;
     onError?: (error: Error) => void;

package/dist/features/account/hooks/usePublicProfile.d.ts

@@ -71,8 +71,8 @@ export declare function usePublicProfile(userId: string, options?: PublicProfile
     loading: boolean;
     profileError: string;
     isSeller: boolean;
-    productsData: NoInfer<ProductsApiResponse> | undefined;
+    productsData: ProductsApiResponse | undefined;
     productsLoading: boolean;
-    reviewsData: NoInfer<SellerReviewsData> | undefined;
+    reviewsData: SellerReviewsData | undefined;
     reviewsLoading: boolean;
 };

package/dist/features/admin/components/AdminAllEventEntriesView.js

@@ -1,5 +1,7 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
+import { sortBy } from "@mohasinac/appkit";
 import React from "react";
 import { useMutation, useQueryClient } from "@tanstack/react-query";
 import { FilterChipGroup, ListingLayout, RowActionMenu, useToast } from "../../../ui";
@@ -33,11 +35,11 @@ export function AdminAllEventEntriesView({ children, ...props }) {
         searchPlaceholder: "Search by user name or event ID",
         emptyLabel: "No entries found",
         filterKeys: ["status"],
-        defaultSort: "-submittedAt",
+        defaultSort: sortBy("submittedAt", "DESC"),
         queryKey: ["admin", "event-entries", "listing"],
         endpoint: ADMIN_ENDPOINTS.ADMIN_EVENT_ENTRIES,
         sortOptions: [
-            { value: "-submittedAt", label: "Newest" },
+            { value: sortBy("submittedAt", "DESC"), label: "Newest" },
             { value: "submittedAt", label: "Oldest" },
         ],
         mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
@@ -51,7 +53,7 @@ export function AdminAllEventEntriesView({ children, ...props }) {
             eventId: toStringValue(item.eventId, ""),
         })),
         getTotal: (response, mappedRows) => typeof response.total === "number" ? response.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,
         renderRowActions: (row) => (_jsx(RowActionMenu, { actions: [
                 {
                     label: ACTIONS.ADMIN["confirm-entry"].label,

package/dist/features/admin/components/AdminBidsView.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 } from "react";
 import { useMutation, useQueryClient } from "@tanstack/react-query";
 import { ConfirmDeleteModal, FilterChipGroup, ListingLayout, RowActionMenu, useToast } from "../../../ui";
@@ -38,13 +40,13 @@ export function AdminBidsView({ children, ...props }) {
         searchPlaceholder: "Search bids, products, or bidder IDs",
         emptyLabel: "No bids found",
         filterKeys: ["status"],
-        defaultSort: "-bidTime",
+        defaultSort: sortBy("bidTime", "DESC"),
         queryKey: ["admin", "bids", "listing"],
         endpoint: ADMIN_ENDPOINTS.BIDS,
         sortOptions: [
-            { value: "-bidTime", label: "Newest" },
+            { value: sortBy("bidTime", "DESC"), label: "Newest" },
             { value: "bidTime", label: "Oldest" },
-            { value: "-amount", label: "Highest amount" },
+            { value: sortBy("amount", "DESC"), label: "Highest amount" },
         ],
         mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
             id: toStringValue(item.id, `bid-${index}`),
@@ -57,7 +59,7 @@ export function AdminBidsView({ children, ...props }) {
             updatedAt: toRelativeDate(item.bidTime ?? item.bidDate ?? item.updatedAt ?? item.createdAt),
         })),
         getTotal: (response, mappedRows) => typeof response.total === "number" ? response.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: (selection) => [
             {
                 id: ROW_ACTION_ID.CANCEL,

package/dist/features/admin/components/AdminBlogView.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 from "react";
 import { FilterChipGroup, ListingLayout } from "../../../ui";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
@@ -22,13 +24,13 @@ export function AdminBlogView({ children, ...props }) {
         searchPlaceholder: "Search articles, authors, or tags",
         emptyLabel: "No blog posts found",
         filterKeys: ["status", "isFeatured"],
-        defaultSort: "-publishedAt",
+        defaultSort: sortBy("publishedAt", "DESC"),
         queryKey: ["admin", "blog", "listing"],
         endpoint: ADMIN_ENDPOINTS.BLOG,
         sortOptions: [
-            { value: "-publishedAt", label: "Latest" },
+            { value: sortBy("publishedAt", "DESC"), label: "Latest" },
             { value: "publishedAt", label: "Oldest" },
-            { value: "-createdAt", label: "Newest draft" },
+            { value: sortBy("createdAt", "DESC"), label: "Newest draft" },
             { value: "title", label: "Title A–Z" },
         ],
         mapRows: (response) => toRecordArray(response.posts).map((item, index) => ({
@@ -51,7 +53,7 @@ export function AdminBlogView({ children, ...props }) {
         buildFilters: (state) => {
             const filterParts = [];
             if (state.status && state.status !== "All")
-                filterParts.push(`status==${state.status}`);
+                filterParts.push(sieveFilter("status", SIEVE_OP.EQ, state.status));
             if (state.isFeatured === "true")
                 filterParts.push("isFeatured==true");
             return filterParts.join(",") || undefined;

package/dist/features/admin/components/AdminBrandsView.js

@@ -1,5 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
+import { sortBy } from "@mohasinac/appkit";
 import React from "react";
 import { Div, ListingLayout, Text } from "../../../ui";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
@@ -34,14 +36,14 @@ const ADMIN_BRANDS_CONFIG = {
     searchPlaceholder: "Search brands by name or slug",
     emptyLabel: "No brands found",
     filterKeys: ["isActive"],
-    defaultSort: "displayOrder",
+    defaultSort: sortBy("displayOrder", "ASC"),
     queryKey: ["admin", "brands", "listing"],
     endpoint: ADMIN_ENDPOINTS.BRANDS,
     sortOptions: [
-        { value: "displayOrder", label: "Display order" },
-        { value: "name", label: "Name A–Z" },
-        { value: "-name", label: "Name Z–A" },
-        { value: "-createdAt", label: "Newest" },
+        { value: sortBy("displayOrder", "ASC"), label: "Display order" },
+        { value: sortBy("name", "ASC"), label: "Name A–Z" },
+        { value: sortBy("name", "DESC"), label: "Name Z–A" },
+        { value: sortBy("createdAt", "DESC"), label: "Newest" },
     ],
     columns: COLUMNS,
     mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
@@ -56,7 +58,7 @@ const ADMIN_BRANDS_CONFIG = {
         updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
     })),
     getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
-    buildFilters: (state) => state.isActive ? `isActive==${state.isActive}` : undefined,
+    buildFilters: (state) => state.isActive ? sieveFilter("isActive", SIEVE_OP.EQ, state.isActive) : undefined,
     primaryAction: {
         label: "Add Brand",
         onClick: ({ openCreatePanel }) => openCreatePanel(),

package/dist/features/admin/components/AdminBundlesView.js

@@ -1,5 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
+import { sortBy } from "@mohasinac/appkit";
 import { useState, useCallback } from "react";
 import { Badge, Button, Div, Stack, Text, useToast } from "../../../ui";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
@@ -61,16 +63,16 @@ export function AdminBundlesView({ getEditHref, newHref }) {
         searchPlaceholder: "Search bundles by name or slug…",
         emptyLabel: BUNDLE_COPY.adminList.empty,
         filterKeys: ["isActive", "bundleStockStatus"],
-        defaultSort: "name",
+        defaultSort: sortBy("name", "ASC"),
         queryKey: ["admin", "bundles", "listing"],
         endpoint: ADMIN_ENDPOINTS.BUNDLES,
         sortOptions: [
-            { value: "name", label: "Name A–Z" },
-            { value: "-name", label: "Name Z–A" },
-            { value: "-bundlePriceInPaise", label: "Price high→low" },
+            { value: sortBy("name", "ASC"), label: "Name A–Z" },
+            { value: sortBy("name", "DESC"), label: "Name Z–A" },
+            { value: sortBy("bundlePriceInPaise", "DESC"), label: "Price high→low" },
             { value: "bundlePriceInPaise", label: "Price low→high" },
-            { value: "-createdAt", label: "Newest" },
-            { value: "createdAt", label: "Oldest" },
+            { value: sortBy("createdAt", "DESC"), label: "Newest" },
+            { value: sortBy("createdAt", "ASC"), label: "Oldest" },
         ],
         columns: COLUMNS,
         mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
@@ -90,9 +92,9 @@ export function AdminBundlesView({ getEditHref, newHref }) {
         buildFilters: (filterState) => {
             const parts = [];
             if (filterState.isActive)
-                parts.push(`isActive==${filterState.isActive}`);
+                parts.push(sieveFilter("isActive", SIEVE_OP.EQ, filterState.isActive));
             if (filterState.bundleStockStatus)
-                parts.push(`bundleStockStatus==${filterState.bundleStockStatus}`);
+                parts.push(sieveFilter("bundleStockStatus", SIEVE_OP.EQ, filterState.bundleStockStatus));
             return parts.join(",") || undefined;
         },
         getRowHref: getEditHref,

package/dist/features/admin/components/AdminCarouselEditorView.js

@@ -59,7 +59,9 @@ const TEXT_ALIGN_OPTIONS = [
 // ── Zone Picker ──────────────────────────────────────────────────────────────
 function ZonePicker({ selected, onChange, disabled, }) {
     const zones = [1, 2, 3, 4, 5, 6];
-    return (_jsxs(Div, { children: [_jsx(Text, { className: "text-xs text-zinc-500 dark:text-zinc-400 mb-1", children: "Zone (row \u00D7 col grid)" }), _jsx("div", { className: "grid gap-1", style: { gridTemplateRows: "repeat(2, 1fr)", gridTemplateColumns: "repeat(3, 1fr)", width: 150 }, children: zones.map((z) => {
+    return (_jsxs(Div, { children: [_jsx(Text, { className: "text-xs text-zinc-500 dark:text-zinc-400 mb-1", children: "Zone (row \u00D7 col grid)" }), _jsx("div", { className: "grid gap-1", 
+                // audit-inline-style-ok: dynamic CSS
+                style: { gridTemplateRows: "repeat(2, 1fr)", gridTemplateColumns: "repeat(3, 1fr)", width: 150 }, children: zones.map((z) => {
                     const isDisabled = disabled?.(z) ?? false;
                     return (_jsx("button", { type: "button", disabled: isDisabled, onClick: () => !isDisabled && onChange(z), className: `rounded text-xs font-mono py-2 border transition-colors ${selected === z
                             ? "bg-primary text-white border-primary"

package/dist/features/admin/components/AdminCartsView.js

@@ -1,5 +1,7 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
+import { sortBy } from "@mohasinac/appkit";
 import React from "react";
 import { FilterChipGroup, ListingLayout } from "../../../ui";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
@@ -12,12 +14,12 @@ const ADMIN_CARTS_CONFIG = {
     searchPlaceholder: "Search by user ID or session",
     emptyLabel: "No carts found",
     filterKeys: ["type"],
-    defaultSort: "-updatedAt",
+    defaultSort: sortBy("updatedAt", "DESC"),
     queryKey: ["admin", "carts", "listing"],
     endpoint: ADMIN_ENDPOINTS.ADMIN_CARTS,
     sortOptions: [
-        { value: "-updatedAt", label: "Recently updated" },
-        { value: "updatedAt", label: "Oldest" },
+        { value: sortBy("updatedAt", "DESC"), label: "Recently updated" },
+        { value: sortBy("updatedAt", "ASC"), label: "Oldest" },
     ],
     mapRows: (response) => toRecordArray(response.items).map((item, index) => {
         const isGuest = !item.userId;
@@ -34,7 +36,7 @@ const ADMIN_CARTS_CONFIG = {
         };
     }),
     getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
-    buildFilters: (state) => state.type && state.type !== "All" ? `type==${state.type}` : undefined,
+    buildFilters: (state) => state.type && state.type !== "All" ? sieveFilter("type", SIEVE_OP.EQ, state.type) : undefined,
     renderFilterPanel: ({ pendingFilters, setPendingFilters }) => (_jsx(FilterChipGroup, { label: "Type", tabs: ADMIN_CART_OWNERSHIP_TABS, value: pendingFilters.type ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, type: id })) })),
 };
 export function AdminCartsView({ children, ...props }) {

package/dist/features/admin/components/AdminCategoriesView.js

@@ -1,5 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
+import { sortBy } from "@mohasinac/appkit";
 import React from "react";
 import { Div, Heading, ListingLayout, Span, Text } from "../../../ui";
 import { CATEGORY_ENDPOINTS } from "../../../constants/api-endpoints";
@@ -33,14 +35,14 @@ const ADMIN_CATEGORIES_CONFIG = {
     searchPlaceholder: "Search categories, slugs, or parent category",
     emptyLabel: "No categories found",
     filterKeys: ["isActive", "isFeatured"],
-    defaultSort: "name",
+    defaultSort: sortBy("name", "ASC"),
     pageSize: 50,
     queryKey: ["admin", "categories", "listing"],
     endpoint: `${CATEGORY_ENDPOINTS.LIST}?flat=true`,
     sortOptions: [
-        { value: "name", label: "Name A–Z" },
-        { value: "-name", label: "Name Z–A" },
-        { value: "-createdAt", label: "Newest" },
+        { value: sortBy("name", "ASC"), label: "Name A–Z" },
+        { value: sortBy("name", "DESC"), label: "Name Z–A" },
+        { value: sortBy("createdAt", "DESC"), label: "Newest" },
     ],
     columns: COLUMNS,
     mapRows: (response) => {
@@ -61,7 +63,7 @@ const ADMIN_CATEGORIES_CONFIG = {
     buildFilters: (state) => {
         const parts = [];
         if (state.isActive)
-            parts.push(`isActive==${state.isActive}`);
+            parts.push(sieveFilter("isActive", SIEVE_OP.EQ, state.isActive));
         if (state.isFeatured === "true")
             parts.push("isFeatured==true");
         return parts.join(",") || undefined;

package/dist/features/admin/components/AdminClassifiedView.js

@@ -4,6 +4,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * AdminClassifiedView — admin browse of classified listings (W1-29).
  * Read-only summary with edit-handoff to the seller-portal edit route.
  */
+import { sortBy } from "@mohasinac/appkit";
 import React from "react";
 import { ListingLayout } from "../../../ui";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
@@ -15,12 +16,12 @@ const ADMIN_CLASSIFIED_CONFIG = {
     searchPlaceholder: "Search classified by name or seller",
     emptyLabel: "No classified listings",
     filterKeys: [],
-    defaultSort: "-createdAt",
+    defaultSort: sortBy("createdAt", "DESC"),
     queryKey: ["admin", "classified", "listing"],
     endpoint: ADMIN_ENDPOINTS.PRODUCTS,
     sortOptions: [
-        { value: "-createdAt", label: "Newest" },
-        { value: "createdAt", label: "Oldest" },
+        { value: sortBy("createdAt", "DESC"), label: "Newest" },
+        { value: sortBy("createdAt", "ASC"), label: "Oldest" },
         { value: "title", label: "Title A–Z" },
     ],
     mapRows: (response) => toRecordArray(response.items).map((item, index) => ({

package/dist/features/admin/components/AdminContactView.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 } from "react";
 import { useMutation, useQueryClient } from "@tanstack/react-query";
 import { ConfirmDeleteModal, FilterChipGroup, ListingLayout, RowActionMenu, useToast } from "../../../ui";
@@ -53,12 +55,12 @@ export function AdminContactView({ children, onBulkMarkRead, onBulkArchive, onBu
         searchPlaceholder: "Search by subject, name, or email",
         emptyLabel: "No contact submissions found",
         filterKeys: ["status"],
-        defaultSort: "-createdAt",
+        defaultSort: sortBy("createdAt", "DESC"),
         queryKey: ["admin", "contact", "listing"],
         endpoint: ADMIN_ENDPOINTS.CONTACT_SUBMISSIONS,
         sortOptions: [
-            { value: "-createdAt", label: "Newest" },
-            { value: "createdAt", label: "Oldest" },
+            { value: sortBy("createdAt", "DESC"), label: "Newest" },
+            { value: sortBy("createdAt", "ASC"), label: "Oldest" },
         ],
         mapRows: (response) => toRecordArray(response.submissions).map((item, index) => ({
             id: toStringValue(item.id, `msg-${index}`),
@@ -77,7 +79,7 @@ export function AdminContactView({ children, onBulkMarkRead, onBulkArchive, onBu
                 return response.meta.total;
             return mappedRows.length;
         },
-        buildFilters: (f) => (f.status && f.status !== "All" ? `status==${f.status}` : undefined),
+        buildFilters: (f) => (f.status && f.status !== "All" ? sieveFilter("status", SIEVE_OP.EQ, f.status) : undefined),
         buildBulkActions: (selection) => [
             ...(onBulkMarkRead
                 ? [

package/dist/features/admin/components/AdminCouponsView.js

@@ -1,5 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
+import { sortBy } from "@mohasinac/appkit";
 import React, { useCallback } from "react";
 import { useQueryClient } from "@tanstack/react-query";
 import { Div, FilterChipGroup, ListingLayout, Text, useToast } from "../../../ui";
@@ -47,12 +49,12 @@ export function AdminCouponsView({ children, onBulkArchive, onBulkDelete, ...pro
         searchPlaceholder: "Search codes, campaigns, or seller scopes",
         emptyLabel: "No coupons found",
         filterKeys: ["type"],
-        defaultSort: "-createdAt",
+        defaultSort: sortBy("createdAt", "DESC"),
         queryKey: ["admin", "coupons", "listing"],
         endpoint: ADMIN_ENDPOINTS.COUPONS,
         sortOptions: [
-            { value: "-createdAt", label: "Newest" },
-            { value: "createdAt", label: "Oldest" },
+            { value: sortBy("createdAt", "DESC"), label: "Newest" },
+            { value: sortBy("createdAt", "ASC"), label: "Oldest" },
             { value: "code", label: "Code A–Z" },
         ],
         hideTableView: true,
@@ -61,7 +63,7 @@ export function AdminCouponsView({ children, onBulkArchive, onBulkDelete, ...pro
             raw: item,
         })),
         getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
-        buildFilters: (state) => state.type && state.type !== "All" ? `type==${state.type}` : undefined,
+        buildFilters: (state) => state.type && state.type !== "All" ? sieveFilter("type", SIEVE_OP.EQ, state.type) : undefined,
         primaryAction: {
             label: "Add Coupon",
             onClick: ({ openCreatePanel }) => openCreatePanel(),

package/dist/features/admin/components/AdminDigitalCodesView.js

@@ -3,6 +3,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * AdminDigitalCodesView — admin browse of digital-code listings (W1-29).
  */
+import { sortBy } from "@mohasinac/appkit";
 import React from "react";
 import { ListingLayout } from "../../../ui";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
@@ -14,12 +15,12 @@ const ADMIN_DIGITAL_CODES_CONFIG = {
     searchPlaceholder: "Search digital code listings",
     emptyLabel: "No digital code listings",
     filterKeys: [],
-    defaultSort: "-createdAt",
+    defaultSort: sortBy("createdAt", "DESC"),
     queryKey: ["admin", "digital-codes", "listing"],
     endpoint: ADMIN_ENDPOINTS.PRODUCTS,
     sortOptions: [
-        { value: "-createdAt", label: "Newest" },
-        { value: "createdAt", label: "Oldest" },
+        { value: sortBy("createdAt", "DESC"), label: "Newest" },
+        { value: sortBy("createdAt", "ASC"), label: "Oldest" },
         { value: "title", label: "Title A–Z" },
     ],
     mapRows: (response) => toRecordArray(response.items).map((item, index) => {

package/dist/features/admin/components/AdminFaqsView.js

@@ -1,5 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
+import { sortBy } from "@mohasinac/appkit";
 import React, { useMemo } from "react";
 import { Div, Heading, ListingLayout, Span, Text } from "../../../ui";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
@@ -35,12 +37,12 @@ export function AdminFaqsView({ children, onBulkArchive, onBulkDelete, ...props
         searchPlaceholder: "Search questions, categories, or tokens",
         emptyLabel: "No FAQs found",
         filterKeys: ["isActive"],
-        defaultSort: "priority",
+        defaultSort: sortBy("priority", "ASC"),
         queryKey: ["admin", "faqs", "listing"],
         endpoint: ADMIN_ENDPOINTS.FAQS,
         sortOptions: [
             { value: "priority", label: "Priority" },
-            { value: "-createdAt", label: "Newest" },
+            { value: sortBy("createdAt", "DESC"), label: "Newest" },
             { value: "question", label: "Question A–Z" },
         ],
         columns: COLUMNS,
@@ -56,7 +58,7 @@ export function AdminFaqsView({ children, onBulkArchive, onBulkDelete, ...props
             updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
         })),
         getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
-        buildFilters: (state) => state.isActive ? `isActive==${state.isActive}` : undefined,
+        buildFilters: (state) => state.isActive ? sieveFilter("isActive", SIEVE_OP.EQ, state.isActive) : undefined,
         primaryAction: {
             label: "Add FAQ",
             onClick: ({ openCreatePanel }) => openCreatePanel(),

package/dist/features/admin/components/AdminFeaturesView.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 { useRouter, useSearchParams, usePathname } from "next/navigation";
 import { ListingLayout, Row } from "../../../ui";
@@ -44,15 +45,15 @@ export function AdminFeaturesView({ children, ...props }) {
         searchPlaceholder: "Search features by label",
         emptyLabel: "No features found",
         filterKeys: [],
-        defaultSort: "displayOrder",
+        defaultSort: sortBy("displayOrder", "ASC"),
         pageSize: PAGE_SIZE,
         queryKey: ["admin", "features", "listing", scopeFilter],
         endpoint: `${ADMIN_ENDPOINTS.PRODUCT_FEATURES}?scope=${scopeFilter}`,
         sortOptions: [
-            { value: "displayOrder", label: "Display order" },
+            { value: sortBy("displayOrder", "ASC"), label: "Display order" },
             { value: "label", label: "Label A–Z" },
-            { value: "-label", label: "Label Z–A" },
-            { value: "-createdAt", label: "Newest" },
+            { value: sortBy("label", "DESC"), label: "Label Z–A" },
+            { value: sortBy("createdAt", "DESC"), label: "Newest" },
         ],
         mapRows: (response) => toRecordArray(response.items).map(mapFeatureRow),
         getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,