@catbee/utils 2.0.0-next.1 → 2.0.0

package/{obj → object}/index.mjs

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -25,7 +25,7 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
-// src/obj/obj.utils.ts
+// src/object/object.utils.ts
 function isObject(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -47,41 +47,42 @@ function omit(obj, keys) {
 __name(omit, "omit");
 function deepObjMerge(target, ...sources) {
   const seen = /* @__PURE__ */ new WeakMap();
-  const mergeInto = /* @__PURE__ */ __name((t, s) => {
-    if (s === void 0) return t;
-    if (typeof s === "function" || typeof s === "symbol") return s;
-    if (Array.isArray(s)) {
+  for (const s of sources) {
+    target = mergeInto(target, s, seen);
+  }
+  return target;
+}
+__name(deepObjMerge, "deepObjMerge");
+function mergeInto(t, s, seen) {
+  if (s === void 0) return t;
+  if (typeof s === "function" || typeof s === "symbol") return s;
+  if (Array.isArray(s)) {
+    const cloned = deepClone(s);
+    seen.set(s, cloned);
+    return cloned;
+  }
+  if (s && typeof s === "object") {
+    if (seen.has(s)) return seen.get(s);
+    if (s instanceof Date || s instanceof Map || s instanceof Set || s instanceof RegExp || s instanceof ArrayBuffer || ArrayBuffer.isView(s)) {
       const cloned = deepClone(s);
       seen.set(s, cloned);
       return cloned;
     }
-    if (s && typeof s === "object") {
-      if (seen.has(s)) return seen.get(s);
-      if (s instanceof Date || s instanceof Map || s instanceof Set || s instanceof RegExp || s instanceof ArrayBuffer || ArrayBuffer.isView(s)) {
-        const cloned = deepClone(s);
-        seen.set(s, cloned);
-        return cloned;
-      }
-      if (!t || typeof t !== "object") {
-        t = Object.create(Object.getPrototypeOf(s));
-      }
-      seen.set(s, t);
-      for (const key of Reflect.ownKeys(s)) {
-        if (key === "__proto__") continue;
-        const sv = s[key];
-        if (sv === void 0) continue;
-        t[key] = mergeInto(t[key], sv);
-      }
-      return t;
+    if (!t || typeof t !== "object") {
+      t = Object.create(Object.getPrototypeOf(s));
     }
-    return s;
-  }, "mergeInto");
-  for (const s of sources) {
-    target = mergeInto(target, s);
+    seen.set(s, t);
+    for (const key of Reflect.ownKeys(s)) {
+      if (key === "__proto__") continue;
+      const sv = s[key];
+      if (sv === void 0) continue;
+      t[key] = mergeInto(t[key], sv, seen);
+    }
+    return t;
   }
-  return target;
+  return s;
 }
-__name(deepObjMerge, "deepObjMerge");
+__name(mergeInto, "mergeInto");
 function isPlainObject(value) {
   if (typeof value !== "object" || value === null) return false;
   if (Array.isArray(value)) return false;
@@ -143,19 +144,59 @@ __name(setValueByPath, "setValueByPath");
 function isEqual(a, b) {
   if (a === b) return true;
   if (a == null || b == null || typeof a !== "object" || typeof b !== "object") return false;
-  if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime();
-  if (a instanceof RegExp && b instanceof RegExp) return a.source === b.source && a.flags === b.flags;
-  if (a instanceof Set && b instanceof Set) return a.size === b.size && [
-    ...a
-  ].every((v) => b.has(v));
-  if (a instanceof Map && b instanceof Map) return a.size === b.size && [
-    ...a
-  ].every(([k, v]) => isEqual(v, b.get(k)));
-  if (a instanceof ArrayBuffer && b instanceof ArrayBuffer) return isEqual(new Uint8Array(a), new Uint8Array(b));
-  if (Array.isArray(a) && Array.isArray(b)) return a.length === b.length && a.every((v, i) => isEqual(v, b[i]));
-  return Object.keys(a).length === Object.keys(b).length && Object.keys(a).every((key) => isEqual(a[key], b[key]));
+  if (a instanceof Date && b instanceof Date) return equalDates(a, b);
+  if (a instanceof RegExp && b instanceof RegExp) return equalRegExp(a, b);
+  if (a instanceof Set && b instanceof Set) return equalSet(a, b);
+  if (a instanceof Map && b instanceof Map) return equalMap(a, b);
+  if (a instanceof ArrayBuffer && b instanceof ArrayBuffer) return equalArrayBuffer(a, b);
+  if (Array.isArray(a) && Array.isArray(b)) return equalArray(a, b);
+  return equalPlainObjects(a, b);
 }
 __name(isEqual, "isEqual");
+function equalDates(a, b) {
+  return a.getTime() === b.getTime();
+}
+__name(equalDates, "equalDates");
+function equalRegExp(a, b) {
+  return a.source === b.source && a.flags === b.flags;
+}
+__name(equalRegExp, "equalRegExp");
+function equalSet(a, b) {
+  if (a.size !== b.size) return false;
+  for (const v of a) if (!b.has(v)) return false;
+  return true;
+}
+__name(equalSet, "equalSet");
+function equalMap(a, b) {
+  if (a.size !== b.size) return false;
+  for (const [k, v] of a) {
+    if (!b.has(k)) return false;
+    if (!isEqual(v, b.get(k))) return false;
+  }
+  return true;
+}
+__name(equalMap, "equalMap");
+function equalArrayBuffer(a, b) {
+  return isEqual(new Uint8Array(a), new Uint8Array(b));
+}
+__name(equalArrayBuffer, "equalArrayBuffer");
+function equalArray(a, b) {
+  if (a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i++) if (!isEqual(a[i], b[i])) return false;
+  return true;
+}
+__name(equalArray, "equalArray");
+function equalPlainObjects(a, b) {
+  const aKeys = Object.keys(a);
+  const bKeys = Object.keys(b);
+  if (aKeys.length !== bKeys.length) return false;
+  for (const key of aKeys) {
+    if (!Object.hasOwn(b, key)) return false;
+    if (!isEqual(a[key], b[key])) return false;
+  }
+  return true;
+}
+__name(equalPlainObjects, "equalPlainObjects");
 function filterObject(obj, predicate) {
   return Object.fromEntries(Object.entries(obj).filter(([key, value]) => predicate(value, key, obj)));
 }
@@ -168,72 +209,75 @@ function mapObject(obj, mapFn) {
 }
 __name(mapObject, "mapObject");
 function _deepClone(value, seen) {
-  if (typeof value === "function" || typeof value === "symbol") {
-    return value;
-  }
-  if (value === null || typeof value !== "object") {
-    return value;
-  }
-  if (seen.has(value)) {
-    return seen.get(value);
-  }
-  let result;
-  if (Array.isArray(value)) {
-    result = [];
-    seen.set(value, result);
-    for (const item of value) {
-      result.push(_deepClone(item, seen));
-    }
-    return result;
-  }
-  if (value instanceof Date) {
-    result = new Date(value.getTime());
-    seen.set(value, result);
-    return result;
-  }
-  if (value instanceof Map) {
-    result = /* @__PURE__ */ new Map();
-    seen.set(value, result);
-    for (const [k, v] of value) {
-      result.set(_deepClone(k, seen), _deepClone(v, seen));
-    }
-    return result;
-  }
-  if (value instanceof Set) {
-    result = /* @__PURE__ */ new Set();
-    seen.set(value, result);
-    for (const v of value) {
-      result.add(_deepClone(v, seen));
-    }
-    return result;
-  }
-  if (value instanceof RegExp) {
-    result = new RegExp(value.source, value.flags);
-    seen.set(value, result);
-    return result;
-  }
-  if (ArrayBuffer.isView(value)) {
-    if (value instanceof DataView) {
-      const buf2 = _deepClone(value.buffer, seen);
-      const clone2 = new DataView(buf2, value.byteOffset, value.byteLength);
-      seen.set(value, clone2);
-      return clone2;
-    }
-    const typed = value;
-    const buf = _deepClone(typed.buffer, seen);
-    const clone = new typed.constructor(buf, typed.byteOffset, typed.length);
-    seen.set(value, clone);
-    return clone;
-  }
-  if (value instanceof ArrayBuffer) {
-    result = value.slice(0);
-    seen.set(value, result);
-    return result;
+  if (typeof value === "function" || typeof value === "symbol") return value;
+  if (value === null || typeof value !== "object") return value;
+  if (seen.has(value)) return seen.get(value);
+  if (Array.isArray(value)) return cloneArray(value, seen);
+  if (value instanceof Date) return cloneDate(value);
+  if (value instanceof Map) return cloneMap(value, seen);
+  if (value instanceof Set) return cloneSet(value, seen);
+  if (value instanceof RegExp) return cloneRegExp(value);
+  if (ArrayBuffer.isView(value)) return cloneArrayBufferView(value, seen);
+  if (value instanceof ArrayBuffer) return cloneArrayBuffer(value, seen);
+  return cloneObject(value, seen);
+}
+__name(_deepClone, "_deepClone");
+function cloneArray(arr, seen) {
+  const result = [];
+  seen.set(arr, result);
+  for (const item of arr) result.push(_deepClone(item, seen));
+  return result;
+}
+__name(cloneArray, "cloneArray");
+function cloneDate(d) {
+  const r = new Date(d.getTime());
+  return r;
+}
+__name(cloneDate, "cloneDate");
+function cloneMap(m, seen) {
+  const result = /* @__PURE__ */ new Map();
+  seen.set(m, result);
+  for (const [k, v] of m) result.set(_deepClone(k, seen), _deepClone(v, seen));
+  return result;
+}
+__name(cloneMap, "cloneMap");
+function cloneSet(s, seen) {
+  const result = /* @__PURE__ */ new Set();
+  seen.set(s, result);
+  for (const v of s) result.add(_deepClone(v, seen));
+  return result;
+}
+__name(cloneSet, "cloneSet");
+function cloneRegExp(r) {
+  const result = new RegExp(r.source, r.flags);
+  return result;
+}
+__name(cloneRegExp, "cloneRegExp");
+function cloneArrayBufferView(view, seen) {
+  if (view instanceof DataView) {
+    const buf2 = _deepClone(view.buffer, seen);
+    const clone2 = new DataView(buf2, view.byteOffset, view.byteLength);
+    seen.set(view, clone2);
+    return clone2;
   }
-  result = Object.create(Object.getPrototypeOf(value));
-  seen.set(value, result);
-  for (const key of Reflect.ownKeys(value)) {
-    const desc = Object.getOwnPropertyDescriptor(value, key);
+  const typed = view;
+  const buf = _deepClone(typed.buffer, seen);
+  const clone = new typed.constructor(buf, typed.byteOffset, typed.length);
+  seen.set(view, clone);
+  return clone;
+}
+__name(cloneArrayBufferView, "cloneArrayBufferView");
+function cloneArrayBuffer(buf, seen) {
+  const result = buf.slice(0);
+  seen.set(buf, result);
+  return result;
+}
+__name(cloneArrayBuffer, "cloneArrayBuffer");
+function cloneObject(obj, seen) {
+  const result = Object.create(Object.getPrototypeOf(obj));
+  seen.set(obj, result);
+  for (const key of Reflect.ownKeys(obj)) {
+    const desc = Object.getOwnPropertyDescriptor(obj, key);
     if (desc?.get || desc?.set) {
       Object.defineProperty(result, key, {
         get: desc.get,
@@ -243,7 +287,7 @@ function _deepClone(value, seen) {
       });
     } else {
       Object.defineProperty(result, key, {
-        value: _deepClone(value[key], seen),
+        value: _deepClone(obj[key], seen),
         writable: desc?.writable ?? true,
         enumerable: desc?.enumerable ?? true,
         configurable: desc?.configurable ?? true
@@ -252,7 +296,7 @@ function _deepClone(value, seen) {
   }
   return result;
 }
-__name(_deepClone, "_deepClone");
+__name(cloneObject, "cloneObject");
 function deepClone(value) {
   const seen = /* @__PURE__ */ new WeakMap();
   return _deepClone(value, seen);
@@ -285,5 +329,32 @@ function getAllPaths(obj, parentPath = "") {
   });
 }
 __name(getAllPaths, "getAllPaths");
+function invert(obj) {
+  if (!isObject(obj)) return {};
+  return Object.fromEntries(Object.entries(obj).map(([k, v]) => [
+    String(v),
+    k
+  ]));
+}
+__name(invert, "invert");
+function invertBy(obj, keyFn) {
+  if (!isObject(obj)) return {};
+  const result = {};
+  for (const [key, value] of Object.entries(obj)) {
+    const newKey = keyFn(value);
+    if (!result[newKey]) result[newKey] = [];
+    result[newKey].push(key);
+  }
+  return result;
+}
+__name(invertBy, "invertBy");
+function transform(obj, fn) {
+  if (!isObject(obj)) return {};
+  return Object.fromEntries(Object.entries(obj).map(([k, v]) => [
+    k,
+    fn(v, k)
+  ]));
+}
+__name(transform, "transform");
 
-export { deepClone, deepFreeze, deepObjMerge, filterObject, flattenObject, getAllPaths, getValueByPath, isEqual, isObjEmpty, isObject, isPlainObject, mapObject, omit, pick, setValueByPath };
+export { deepClone, deepFreeze, deepObjMerge, filterObject, flattenObject, getAllPaths, getValueByPath, invert, invertBy, isEqual, isObjEmpty, isObject, isPlainObject, mapObject, omit, pick, setValueByPath, transform };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@catbee/utils",
-  "version": "2.0.0-next.1",
+  "version": "2.0.0",
   "description": "A modular, production-grade utility toolkit for Node.js and TypeScript, designed for robust, scalable applications (including Express-based services). All utilities are tree-shakable and can be imported independently.",
   "publishConfig": {
     "access": "public"
@@ -57,6 +57,24 @@
     "LICENSE",
     "README.md"
   ],
+  "keywords": [
+    "catbee",
+    "catbee-utils",
+    "utils",
+    "utilities",
+    "helper",
+    "helpers",
+    "tools",
+    "typescript",
+    "nodejs",
+    "node",
+    "esm",
+    "commonjs",
+    "express",
+    "expressjs",
+    "express-server",
+    "developer-tools"
+  ],
   "exports": {
     ".": {
       "import": "./index.mjs",
@@ -98,15 +116,15 @@
       "require": "./date/index.cjs",
       "types": "./date/index.d.ts"
     },
-    "./decorators": {
-      "import": "./decorators/index.mjs",
-      "require": "./decorators/index.cjs",
-      "types": "./decorators/index.d.ts"
+    "./decorator": {
+      "import": "./decorator/index.mjs",
+      "require": "./decorator/index.cjs",
+      "types": "./decorator/index.d.ts"
     },
-    "./dir": {
-      "import": "./dir/index.mjs",
-      "require": "./dir/index.cjs",
-      "types": "./dir/index.d.ts"
+    "./directory": {
+      "import": "./directory/index.mjs",
+      "require": "./directory/index.cjs",
+      "types": "./directory/index.d.ts"
     },
     "./env": {
       "import": "./env/index.mjs",
@@ -143,10 +161,10 @@
       "require": "./middleware/index.cjs",
       "types": "./middleware/index.d.ts"
     },
-    "./obj": {
-      "import": "./obj/index.mjs",
-      "require": "./obj/index.cjs",
-      "types": "./obj/index.d.ts"
+    "./object": {
+      "import": "./object/index.mjs",
+      "require": "./object/index.cjs",
+      "types": "./object/index.d.ts"
     },
     "./performance": {
       "import": "./performance/index.mjs",

package/performance/index.cjs

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -201,7 +201,7 @@ function trackMemoryUsage(fn, options = {}) {
   const afterMemory = process.memoryUsage();
   const diff = {};
   for (const key in afterMemory) {
-    if (Object.prototype.hasOwnProperty.call(afterMemory, key)) {
+    if (Object.hasOwn(afterMemory, key)) {
       diff[key] = afterMemory[key] - beforeMemory[key];
     }
   }

package/performance/index.d.ts

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal

package/performance/index.mjs

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -199,7 +199,7 @@ function trackMemoryUsage(fn, options = {}) {
   const afterMemory = process.memoryUsage();
   const diff = {};
   for (const key in afterMemory) {
-    if (Object.prototype.hasOwnProperty.call(afterMemory, key)) {
+    if (Object.hasOwn(afterMemory, key)) {
       diff[key] = afterMemory[key] - beforeMemory[key];
     }
   }

package/request/index.cjs

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -143,38 +143,50 @@ function extractPaginationParams(query, defaultPage = 1, defaultLimit = 20, maxL
   };
 }
 __name(extractPaginationParams, "extractPaginationParams");
-function extractSortParams(query, allowedFields, defaultSort = {
+var DEFAULT_SORT = {
   sortBy: "createdAt",
   sortOrder: "desc"
-}) {
-  let sortBy = defaultSort.sortBy;
-  let sortOrder = defaultSort.sortOrder;
-  if (typeof query.sortBy === "string") {
-    sortBy = query.sortBy;
-  } else if (Array.isArray(query.sortBy)) {
-    sortBy = query.sortBy[0];
-  } else if (typeof query.sort === "string") {
-    sortBy = query.sort.startsWith("-") ? query.sort.slice(1) : query.sort;
-    sortOrder = query.sort.startsWith("-") ? "desc" : "asc";
-  } else if (Array.isArray(query.sort)) {
-    sortBy = query.sort[0].startsWith("-") ? query.sort[0].slice(1) : query.sort[0];
-    sortOrder = query.sort[0].startsWith("-") ? "desc" : "asc";
-  }
-  if (typeof query.sortOrder === "string") {
-    const order = query.sortOrder.toLowerCase();
-    if (order === "asc" || order === "desc") {
-      sortOrder = order;
-    }
-  }
-  if (allowedFields.length && !allowedFields.includes(sortBy)) {
-    sortBy = defaultSort.sortBy;
+};
+function extractSortParams(query, allowedFields, defaultSort = DEFAULT_SORT) {
+  const inferredSortBy = getSortByFromQuery(query, defaultSort);
+  let sortOrder = getSortOrderFromQuery(query, defaultSort);
+  const explicit = applyExplicitSortOrder(query.sortOrder);
+  if (explicit) {
+    sortOrder = explicit;
   }
+  const sortBy = validateSortField(inferredSortBy, allowedFields, defaultSort.sortBy);
   return {
     sortBy,
     sortOrder
   };
 }
 __name(extractSortParams, "extractSortParams");
+function getSortByFromQuery(query, defaultSort) {
+  if (typeof query.sortBy === "string") return query.sortBy;
+  if (Array.isArray(query.sortBy)) return query.sortBy[0];
+  if (typeof query.sort === "string") return query.sort.startsWith("-") ? query.sort.slice(1) : query.sort;
+  if (Array.isArray(query.sort)) return query.sort[0].startsWith("-") ? query.sort[0].slice(1) : query.sort[0];
+  return defaultSort.sortBy;
+}
+__name(getSortByFromQuery, "getSortByFromQuery");
+function getSortOrderFromQuery(query, defaultSort) {
+  if (typeof query.sort === "string") return query.sort.startsWith("-") ? "desc" : "asc";
+  if (Array.isArray(query.sort)) return query.sort[0].startsWith("-") ? "desc" : "asc";
+  return defaultSort.sortOrder;
+}
+__name(getSortOrderFromQuery, "getSortOrderFromQuery");
+function applyExplicitSortOrder(sortOrderParam) {
+  if (typeof sortOrderParam !== "string") return null;
+  const order = sortOrderParam.toLowerCase();
+  if (order === "asc" || order === "desc") return order;
+  return null;
+}
+__name(applyExplicitSortOrder, "applyExplicitSortOrder");
+function validateSortField(sortBy, allowedFields, defaultSortBy) {
+  if (allowedFields.length && !allowedFields.includes(sortBy)) return defaultSortBy;
+  return sortBy;
+}
+__name(validateSortField, "validateSortField");
 function extractFilterParams(query, allowedFilters) {
   const filters = {};
   for (const field of allowedFilters) {

package/request/index.d.ts

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal

package/request/index.mjs

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -141,38 +141,50 @@ function extractPaginationParams(query, defaultPage = 1, defaultLimit = 20, maxL
   };
 }
 __name(extractPaginationParams, "extractPaginationParams");
-function extractSortParams(query, allowedFields, defaultSort = {
+var DEFAULT_SORT = {
   sortBy: "createdAt",
   sortOrder: "desc"
-}) {
-  let sortBy = defaultSort.sortBy;
-  let sortOrder = defaultSort.sortOrder;
-  if (typeof query.sortBy === "string") {
-    sortBy = query.sortBy;
-  } else if (Array.isArray(query.sortBy)) {
-    sortBy = query.sortBy[0];
-  } else if (typeof query.sort === "string") {
-    sortBy = query.sort.startsWith("-") ? query.sort.slice(1) : query.sort;
-    sortOrder = query.sort.startsWith("-") ? "desc" : "asc";
-  } else if (Array.isArray(query.sort)) {
-    sortBy = query.sort[0].startsWith("-") ? query.sort[0].slice(1) : query.sort[0];
-    sortOrder = query.sort[0].startsWith("-") ? "desc" : "asc";
-  }
-  if (typeof query.sortOrder === "string") {
-    const order = query.sortOrder.toLowerCase();
-    if (order === "asc" || order === "desc") {
-      sortOrder = order;
-    }
-  }
-  if (allowedFields.length && !allowedFields.includes(sortBy)) {
-    sortBy = defaultSort.sortBy;
+};
+function extractSortParams(query, allowedFields, defaultSort = DEFAULT_SORT) {
+  const inferredSortBy = getSortByFromQuery(query, defaultSort);
+  let sortOrder = getSortOrderFromQuery(query, defaultSort);
+  const explicit = applyExplicitSortOrder(query.sortOrder);
+  if (explicit) {
+    sortOrder = explicit;
   }
+  const sortBy = validateSortField(inferredSortBy, allowedFields, defaultSort.sortBy);
   return {
     sortBy,
     sortOrder
   };
 }
 __name(extractSortParams, "extractSortParams");
+function getSortByFromQuery(query, defaultSort) {
+  if (typeof query.sortBy === "string") return query.sortBy;
+  if (Array.isArray(query.sortBy)) return query.sortBy[0];
+  if (typeof query.sort === "string") return query.sort.startsWith("-") ? query.sort.slice(1) : query.sort;
+  if (Array.isArray(query.sort)) return query.sort[0].startsWith("-") ? query.sort[0].slice(1) : query.sort[0];
+  return defaultSort.sortBy;
+}
+__name(getSortByFromQuery, "getSortByFromQuery");
+function getSortOrderFromQuery(query, defaultSort) {
+  if (typeof query.sort === "string") return query.sort.startsWith("-") ? "desc" : "asc";
+  if (Array.isArray(query.sort)) return query.sort[0].startsWith("-") ? "desc" : "asc";
+  return defaultSort.sortOrder;
+}
+__name(getSortOrderFromQuery, "getSortOrderFromQuery");
+function applyExplicitSortOrder(sortOrderParam) {
+  if (typeof sortOrderParam !== "string") return null;
+  const order = sortOrderParam.toLowerCase();
+  if (order === "asc" || order === "desc") return order;
+  return null;
+}
+__name(applyExplicitSortOrder, "applyExplicitSortOrder");
+function validateSortField(sortBy, allowedFields, defaultSortBy) {
+  if (allowedFields.length && !allowedFields.includes(sortBy)) return defaultSortBy;
+  return sortBy;
+}
+__name(validateSortField, "validateSortField");
 function extractFilterParams(query, allowedFilters) {
   const filters = {};
   for (const field of allowedFilters) {

package/response/index.cjs

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal

package/response/index.d.ts

@@ -1,7 +1,7 @@
 /*
  * The MIT License
  * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * Copyright (c) 2026 Catbee Technologies. https://catbee.in/license
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal