@catbee/utils 2.0.0-next.1 → 2.0.0

package/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
@@ -31,8 +31,8 @@ export * from './cache';
 export * from './context-store';
 export * from './crypto';
 export * from './date';
-export * from './decorators';
-export * from './dir';
+export * from './decorator';
+export * from './directory';
 export * from './env';
 export * from './exception';
 export * from './fs';
@@ -40,7 +40,7 @@ export * from './http-status-codes';
 export * from './id';
 export * from './logger';
 export * from './middleware';
-export * from './obj';
+export * from './object';
 export * from './performance';
 export * from './request';
 export * from './response';

package/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
@@ -31,8 +31,8 @@ export * from "./cache/index.mjs";
 export * from "./context-store/index.mjs";
 export * from "./crypto/index.mjs";
 export * from "./date/index.mjs";
-export * from "./decorators/index.mjs";
-export * from "./dir/index.mjs";
+export * from "./decorator/index.mjs";
+export * from "./directory/index.mjs";
 export * from "./env/index.mjs";
 export * from "./exception/index.mjs";
 export * from "./fs/index.mjs";
@@ -40,7 +40,7 @@ export * from "./http-status-codes/index.mjs";
 export * from "./id/index.mjs";
 export * from "./logger/index.mjs";
 export * from "./middleware/index.mjs";
-export * from "./obj/index.mjs";
+export * from "./object/index.mjs";
 export * from "./performance/index.mjs";
 export * from "./request/index.mjs";
 export * from "./response/index.mjs";

package/logger/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
@@ -133,9 +133,7 @@ function addRedactFields(fields) {
 __name(addRedactFields, "addRedactFields");
 var cachedExpandedFields = null;
 function getExpandedSensitiveFields() {
-  if (!cachedExpandedFields) {
-    cachedExpandedFields = expandSensitiveFields(defaultSensitiveFields);
-  }
+  cachedExpandedFields ??= expandSensitiveFields(defaultSensitiveFields);
   return cachedExpandedFields;
 }
 __name(getExpandedSensitiveFields, "getExpandedSensitiveFields");

package/logger/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
@@ -188,7 +188,7 @@ declare function createRequestLogger(requestId: string, additionalContext?: Reco
  * @param {string} [message] - Optional message to include
  * @param {Record<string, any>} [context] - Additional context properties
  */
-declare function logError(error: Error | unknown, message?: string, context?: Record<string, any>): void;
+declare function logError(error: Error | string, message?: string, context?: Record<string, any>): void;
 /**
  * Expands multiple sensitive field names into their variants.
  * Useful to match fields like `api_key`, `apiKey`, `apikey`, `APIKEY`, etc.

package/logger/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
@@ -127,9 +127,7 @@ function addRedactFields(fields) {
 __name(addRedactFields, "addRedactFields");
 var cachedExpandedFields = null;
 function getExpandedSensitiveFields() {
-  if (!cachedExpandedFields) {
-    cachedExpandedFields = expandSensitiveFields(defaultSensitiveFields);
-  }
+  cachedExpandedFields ??= expandSensitiveFields(defaultSensitiveFields);
   return cachedExpandedFields;
 }
 __name(getExpandedSensitiveFields, "getExpandedSensitiveFields");

package/middleware/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/middleware/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/middleware/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

package/{obj → object}/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
@@ -27,7 +27,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);
 }
@@ -49,41 +49,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;
@@ -145,19 +146,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)));
 }
@@ -170,72 +211,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,
@@ -245,7 +289,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
@@ -254,7 +298,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);
@@ -287,6 +331,33 @@ 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");
 
 exports.deepClone = deepClone;
 exports.deepFreeze = deepFreeze;
@@ -295,6 +366,8 @@ exports.filterObject = filterObject;
 exports.flattenObject = flattenObject;
 exports.getAllPaths = getAllPaths;
 exports.getValueByPath = getValueByPath;
+exports.invert = invert;
+exports.invertBy = invertBy;
 exports.isEqual = isEqual;
 exports.isObjEmpty = isObjEmpty;
 exports.isObject = isObject;
@@ -303,3 +376,4 @@ exports.mapObject = mapObject;
 exports.omit = omit;
 exports.pick = pick;
 exports.setValueByPath = setValueByPath;
+exports.transform = transform;

package/{obj → object}/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
@@ -156,5 +156,41 @@ declare function deepFreeze<T extends object>(obj: T): Readonly<T>;
  * @returns {string[]} Array of all paths in dot notation.
  */
 declare function getAllPaths(obj: Record<string, any>, parentPath?: string): string[];
+/**
+ * Inverts an object's keys and values.
+ *
+ * @template T
+ * @param {T} obj - The object to invert.
+ * @returns {Record<string, string>} Inverted object.
+ *
+ * @example
+ * invert({ a: 'x', b: 'y' }); // { x: 'a', y: 'b' }
+ */
+declare function invert<T extends Record<string, any>>(obj: T): Record<string, string>;
+/**
+ * Inverts an object using a function to generate keys from values.
+ *
+ * @template T
+ * @param {T} obj - The object to invert.
+ * @param {(value: any) => string} keyFn - Function to generate new keys.
+ * @returns {Record<string, string[]>} Inverted object with arrays of keys.
+ *
+ * @example
+ * invertBy({ a: 1, b: 2, c: 1 }, v => String(v)); // { '1': ['a', 'c'], '2': ['b'] }
+ */
+declare function invertBy<T extends Record<string, any>>(obj: T, keyFn: (value: any) => string): Record<string, string[]>;
+/**
+ * Transforms object values using a mapping function.
+ *
+ * @template T
+ * @template U
+ * @param {T} obj - The source object.
+ * @param {(value: any, key: string) => U} fn - Transformation function.
+ * @returns {Record<string, U>} Object with transformed values.
+ *
+ * @example
+ * transform({ a: 1, b: 2 }, v => v * 2); // { a: 2, b: 4 }
+ */
+declare function transform<T extends Record<string, any>, U>(obj: T, fn: (value: any, key: string) => U): Record<string, U>;
 
-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 };