@mohasinac/appkit 2.8.3 → 2.8.4

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/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/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,

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

@@ -4,6 +4,7 @@ import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-run
  * AdminGroupedListingsView — admin moderation view for grouped product listings.
  * W1-29 — pairs with the new GET /api/admin/grouped-listings endpoint.
  */
+import { sortBy } from "@mohasinac/appkit";
 import React, { useState } from "react";
 import { ListingLayout } from "../../../ui";
 import { Button, Row, SideDrawer, Stack, Text, useToast, } from "../../../ui";
@@ -42,12 +43,12 @@ export function AdminGroupedListingsView({ children, ...props }) {
         searchPlaceholder: "Search grouped listings by title or seller",
         emptyLabel: "No grouped listings",
         filterKeys: [],
-        defaultSort: "-createdAt",
+        defaultSort: sortBy("createdAt", "DESC"),
         queryKey: ["admin", "grouped-listings", refreshKey],
         endpoint: ADMIN_ENDPOINTS.GROUPED_LISTINGS,
         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/AdminHistoryView.js

@@ -4,6 +4,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * AdminHistoryView — read-only admin insights for the top-level `history` collection.
  * One row per user with item count + last visit. Mirrors AdminWishlistsView.
  */
+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_HISTORY_CONFIG = {
     searchPlaceholder: "Search by user ID",
     emptyLabel: "No user history records found",
     filterKeys: [],
-    defaultSort: "-updatedAt",
+    defaultSort: sortBy("updatedAt", "DESC"),
     queryKey: ["admin", "history", "listing"],
     endpoint: ADMIN_ENDPOINTS.ADMIN_HISTORY,
     sortOptions: [
-        { value: "-updatedAt", label: "Recently active" },
-        { value: "-itemCount", label: "Largest first" },
+        { value: sortBy("updatedAt", "DESC"), label: "Recently active" },
+        { value: sortBy("itemCount", "DESC"), label: "Largest first" },
     ],
     mapRows: (response) => toRecordArray(response.items).map((item, index) => {
         const itemCount = typeof item.itemCount === "number" ? item.itemCount : 0;

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

@@ -3,6 +3,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * AdminLiveView — admin browse of live-item 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_LIVE_CONFIG = {
     searchPlaceholder: "Search live items",
     emptyLabel: "No live item listings",
     filterKeys: [],
-    defaultSort: "-createdAt",
+    defaultSort: sortBy("createdAt", "DESC"),
     queryKey: ["admin", "live-items", "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) => {