@catbee/utils 2.0.0-next.0 → 2.0.0

package/obj/index.mjs

@@ -1,301 +0,0 @@
-/*
- * The MIT License
- * 
- * Copyright (c) 2025 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
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- * 
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- * 
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-
-// src/obj/obj.utils.ts
-function isObjEmpty(obj) {
-  return !!obj && typeof obj === "object" && Object.keys(obj).length === 0;
-}
-__name(isObjEmpty, "isObjEmpty");
-function pick(obj, keys) {
-  return Object.fromEntries(keys.map((key) => [
-    key,
-    obj[key]
-  ]));
-}
-__name(pick, "pick");
-function omit(obj, keys) {
-  return Object.fromEntries(Object.entries(obj).filter(([key]) => !keys.includes(key)));
-}
-__name(omit, "omit");
-function deepObjMerge(target, ...sources) {
-  if (!sources.length) return target;
-  const seen = /* @__PURE__ */ new WeakMap();
-  seen.set(target, target);
-  for (const s of sources) {
-    if (s && typeof s === "object") {
-      seen.set(s, target);
-    }
-  }
-  function deepClone2(value) {
-    if (value === null || typeof value !== "object") return value;
-    if (seen.has(value)) return seen.get(value);
-    if (value instanceof Date) {
-      return new Date(value.getTime());
-    }
-    if (Array.isArray(value)) {
-      const clone2 = [];
-      seen.set(value, clone2);
-      value.forEach((item, i) => clone2[i] = deepClone2(item));
-      return clone2;
-    }
-    if (value instanceof Set) {
-      const clone2 = /* @__PURE__ */ new Set();
-      seen.set(value, clone2);
-      value.forEach((item) => clone2.add(deepClone2(item)));
-      return clone2;
-    }
-    if (value instanceof Map) {
-      const clone2 = /* @__PURE__ */ new Map();
-      seen.set(value, clone2);
-      value.forEach((val, key) => clone2.set(key, deepClone2(val)));
-      return clone2;
-    }
-    if (value instanceof RegExp) {
-      return new RegExp(value.source, value.flags);
-    }
-    if (value instanceof ArrayBuffer) {
-      return value.slice(0);
-    }
-    if (ArrayBuffer.isView(value) && !(value instanceof DataView)) {
-      const typed = value;
-      const ctor = typed.constructor;
-      const typedArrayCtors = [
-        Int8Array,
-        Uint8Array,
-        Uint8ClampedArray,
-        Int16Array,
-        Uint16Array,
-        Int32Array,
-        Uint32Array,
-        Float32Array,
-        Float64Array,
-        BigInt64Array,
-        BigUint64Array
-      ].filter(Boolean);
-      const typedArrayCtorSet = new Set(typedArrayCtors);
-      if (typeof ctor === "function" && typedArrayCtorSet.has(ctor)) {
-        const buffer = typed.buffer && typeof typed.buffer.slice === "function" ? typed.buffer.slice(0) : typed.buffer;
-        const clone2 = new ctor(buffer, typed.byteOffset, typed.length);
-        seen.set(value, clone2);
-        return clone2;
-      } else if (typeof typed.slice === "function") {
-        const clone2 = typed.slice();
-        seen.set(value, clone2);
-        return clone2;
-      } else {
-        throw new Error("Cannot deep clone unknown TypedArray type: " + (typed && typed.constructor && typed.constructor.name));
-      }
-    }
-    const clone = Object.create(Object.getPrototypeOf(value));
-    seen.set(value, clone);
-    Reflect.ownKeys(value).forEach((key) => {
-      const descriptor = Object.getOwnPropertyDescriptor(value, key);
-      if (descriptor.get || descriptor.set) {
-        Object.defineProperty(clone, key, descriptor);
-      } else {
-        clone[key] = deepClone2(value[key]);
-      }
-    });
-    return clone;
-  }
-  __name(deepClone2, "deepClone");
-  function mergeProp(target2, source, key) {
-    const targetValue = target2[key];
-    const sourceValue = source[key];
-    if (sourceValue === void 0) return;
-    if (sourceValue === null || typeof sourceValue !== "object") {
-      target2[key] = sourceValue;
-      return;
-    }
-    if (Array.isArray(sourceValue)) {
-      target2[key] = deepClone2(sourceValue);
-      return;
-    }
-    if (sourceValue instanceof Date || sourceValue instanceof RegExp || sourceValue instanceof Set || sourceValue instanceof Map || sourceValue instanceof ArrayBuffer || ArrayBuffer.isView(sourceValue) && !(sourceValue instanceof DataView)) {
-      target2[key] = deepClone2(sourceValue);
-      return;
-    }
-    if (isPlainObject(sourceValue) && isPlainObject(targetValue)) {
-      for (const k of Reflect.ownKeys(sourceValue)) {
-        mergeProp(targetValue, sourceValue, k);
-      }
-      return;
-    }
-    target2[key] = deepClone2(sourceValue);
-  }
-  __name(mergeProp, "mergeProp");
-  for (const source of sources) {
-    if (source == null) continue;
-    for (const key of Reflect.ownKeys(source)) {
-      mergeProp(target, source, key);
-    }
-  }
-  return target;
-}
-__name(deepObjMerge, "deepObjMerge");
-function isPlainObject(value) {
-  if (typeof value !== "object" || value === null) return false;
-  if (Array.isArray(value)) return false;
-  const proto = Object.getPrototypeOf(value);
-  return proto === Object.prototype || proto === null;
-}
-__name(isPlainObject, "isPlainObject");
-function flattenObject(obj, prefix = "") {
-  return Object.entries(obj).reduce((acc, [key, value]) => {
-    const newKey = prefix ? `${prefix}.${key}` : key;
-    if (value && typeof value === "object" && !Array.isArray(value)) {
-      Object.assign(acc, flattenObject(value, newKey));
-    } else {
-      acc[newKey] = value;
-    }
-    return acc;
-  }, {});
-}
-__name(flattenObject, "flattenObject");
-function getValueByPath(obj, path) {
-  if (!obj || typeof obj !== "object") return void 0;
-  const parts = path.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
-  return parts.reduce((acc, key) => acc?.[key], obj);
-}
-__name(getValueByPath, "getValueByPath");
-function setValueByPath(obj, path, value) {
-  if (!obj || typeof obj !== "object") return obj;
-  const parts = path.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
-  if (parts.length === 0) return obj;
-  const forbiddenKeys = /* @__PURE__ */ new Set([
-    "__proto__",
-    "prototype",
-    "constructor"
-  ]);
-  let current = obj;
-  for (let i = 0; i < parts.length - 1; i++) {
-    const key = parts[i];
-    if (forbiddenKeys.has(key)) {
-      return obj;
-    }
-    const nextKey = parts[i + 1];
-    const isArrayIndex = !isNaN(Number(nextKey));
-    if (current[key] === void 0) {
-      current[key] = isArrayIndex ? [] : /* @__PURE__ */ Object.create(null);
-    } else if (typeof current[key] !== "object" || current[key] === null) {
-      current[key] = isArrayIndex ? [] : /* @__PURE__ */ Object.create(null);
-    }
-    current = current[key];
-  }
-  const finalKey = parts[parts.length - 1];
-  if (forbiddenKeys.has(finalKey)) {
-    return obj;
-  }
-  current[finalKey] = value;
-  return obj;
-}
-__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 Date || b instanceof Date) {
-    return false;
-  }
-  if (Array.isArray(a) && Array.isArray(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;
-  }
-  if (Array.isArray(a) || Array.isArray(b)) {
-    return false;
-  }
-  const keysA = Object.keys(a);
-  const keysB = Object.keys(b);
-  if (keysA.length !== keysB.length) return false;
-  return keysA.every((key) => Object.prototype.hasOwnProperty.call(b, key) && isEqual(a[key], b[key]));
-}
-__name(isEqual, "isEqual");
-function filterObject(obj, predicate) {
-  return Object.fromEntries(Object.entries(obj).filter(([key, value]) => predicate(value, key, obj)));
-}
-__name(filterObject, "filterObject");
-function mapObject(obj, mapFn) {
-  return Object.fromEntries(Object.entries(obj).map(([key, value]) => [
-    key,
-    mapFn(value, key, obj)
-  ]));
-}
-__name(mapObject, "mapObject");
-function deepClone(value) {
-  try {
-    if (typeof globalThis.structuredClone === "function") {
-      return globalThis.structuredClone(value);
-    }
-  } catch (_) {
-  }
-  try {
-    return JSON.parse(JSON.stringify(value));
-  } catch (_) {
-    return value;
-  }
-}
-__name(deepClone, "deepClone");
-function deepFreeze(obj) {
-  Object.freeze(obj);
-  for (const prop of Object.getOwnPropertyNames(obj)) {
-    const value = obj[prop];
-    if (value !== null && typeof value === "object" && !Object.isFrozen(value)) {
-      deepFreeze(value);
-    }
-  }
-  return obj;
-}
-__name(deepFreeze, "deepFreeze");
-function isObject(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-__name(isObject, "isObject");
-function getAllPaths(obj, parentPath = "") {
-  if (!isObject(obj)) return [];
-  return Object.entries(obj).flatMap(([key, value]) => {
-    const currentPath = parentPath ? `${parentPath}.${key}` : key;
-    if (isObject(value)) {
-      return [
-        currentPath,
-        ...getAllPaths(value, currentPath)
-      ];
-    }
-    return [
-      currentPath
-    ];
-  });
-}
-__name(getAllPaths, "getAllPaths");
-
-export { deepClone, deepFreeze, deepObjMerge, filterObject, flattenObject, getAllPaths, getValueByPath, isEqual, isObjEmpty, isObject, isPlainObject, mapObject, omit, pick, setValueByPath };

package/performance/performance.utils.d.ts

@@ -1,159 +0,0 @@
-/*
- * The MIT License
- * 
- * Copyright (c) 2025 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
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- * 
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- * 
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-/**
- * Options for timing function execution.
- */
-export interface TimingOptions {
-    /** Optional label for the timing (defaults to function name) */
-    label?: string;
-    /** Whether to log the timing (default: false) */
-    log?: boolean;
-    /** Log level to use if logging is enabled (default: 'debug') */
-    logLevel?: 'trace' | 'debug' | 'info' | 'warn' | 'error';
-}
-/**
- * Result of a timing operation.
- */
-export interface TimingResult {
-    /** Duration in milliseconds */
-    durationMs: number;
-    /** Duration in seconds */
-    durationSec: number;
-    /** Start timestamp */
-    startTime: number;
-    /** End timestamp */
-    endTime: number;
-    /** Label used for the timing */
-    label: string;
-}
-/**
- * Measure the execution time of a synchronous function.
- *
- * @param fn - Function to measure
- * @param options - Timing options
- * @returns Result containing the return value and timing information
- *
- * @example
- * ```typescript
- * const { result, timing } = timeSync(() => {
- *   // Some expensive operation
- *   return computeResult();
- * }, { label: 'Computation', log: true });
- *
- * console.log(`Result: ${result}, took ${timing.durationMs}ms`);
- * ```
- */
-export declare function timeSync<T>(fn: () => T, options?: TimingOptions): {
-    result: T;
-    timing: TimingResult;
-};
-/**
- * Measure the execution time of an asynchronous function.
- *
- * @param fn - Async function to measure
- * @param options - Timing options
- * @returns Promise resolving to result and timing information
- *
- * @example
- * ```typescript
- * const { result, timing } = await timeAsync(async () => {
- *   // Some expensive async operation
- *   const data = await fetchData();
- *   return processData(data);
- * }, { label: 'API Request', log: true });
- *
- * console.log(`Fetched ${result.length} items in ${timing.durationSec.toFixed(2)}s`);
- * ```
- */
-export declare function timeAsync<T>(fn: () => Promise<T>, options?: TimingOptions): Promise<{
-    result: T;
-    timing: TimingResult;
-}>;
-/**
- * Create a timing decorator for class methods.
- *
- * @param options - Timing options
- * @returns Method decorator
- *
- * @example
- * ```typescript
- * class DataService {
- *   @timed({ log: true, logLevel: 'info' })
- *   async fetchData() {
- *     // ...implementation
- *   }
- * }
- * ```
- */
-export declare function timed(options?: TimingOptions): (target: any, propertyKeyOrContext: string | symbol | any, descriptor?: PropertyDescriptor) => void;
-/**
- * Memoize function results with optional TTL and max cache size.
- *
- * @param fn - Function to memoize
- * @param options - Memoization options
- * @returns Memoized function
- *
- * @example
- * ```typescript
- * // Cache results for 30 seconds, with a maximum of 100 entries
- * const cachedFetch = memoize(
- *   async (url) => {
- *     const response = await fetch(url);
- *     return response.json();
- *   },
- *   { ttl: 30000, maxSize: 100, cacheKey: (url) => url }
- * );
- * ```
- */
-export declare function memoize<T, Args extends any[]>(fn: (...args: Args) => T, options?: {
-    /** Time-to-live in milliseconds (default: indefinite) */
-    ttl?: number;
-    /** Maximum cache size (default: unlimited) */
-    maxSize?: number;
-    /** Function to generate a cache key from arguments */
-    cacheKey?: (...args: Args) => string;
-    /** Auto-cleanup interval in milliseconds (default: disabled) */
-    autoCleanupMs?: number;
-}): (...args: Args) => T;
-/**
- * Track memory usage for a function execution.
- *
- * @param fn - Function to track
- * @param options - Memory tracking options
- * @returns Result and memory usage information
- */
-export declare function trackMemoryUsage<T>(fn: () => T, options?: {
-    /** Whether to log the memory usage (default: false) */
-    log?: boolean;
-    /** Label for the memory tracking (default: function name) */
-    label?: string;
-}): {
-    result: T;
-    memoryUsage: {
-        before: NodeJS.MemoryUsage;
-        after: NodeJS.MemoryUsage;
-        diff: Record<string, number>;
-    };
-};

package/request/request.utils.d.ts

@@ -1,109 +0,0 @@
-/*
- * The MIT License
- * 
- * Copyright (c) 2025 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
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- * 
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- * 
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-import { Request } from 'express';
-import type { WithPagination } from '@catbee/utils/response';
-/**
- * Options for parsing and validating request parameters.
- */
-export interface ValidationOptions {
-    /** Whether to throw an error on validation failure */
-    throwOnError?: boolean;
-    /** Custom error message for validation failures */
-    errorMessage?: string;
-    /** Default value to use if parameter is missing */
-    defaultValue?: any;
-    /** Whether the parameter is required */
-    required?: boolean;
-}
-/**
- * Result of a parameter validation operation.
- */
-export interface ValidationResult<T> {
-    /** Whether validation was successful */
-    isValid: boolean;
-    /** The validated and potentially transformed value */
-    value: T | null;
-    /** Error message if validation failed */
-    error?: string;
-}
-/**
- * Extracts pagination, sorting, and optional search params from a request.
- *
- * @param req - Express request
- * @returns Object containing validated pagination, sorting, and additional query params
- */
-export declare const getPaginationParams: <T = {}>(req: Request) => WithPagination<T>;
-/**
- * Safely parses a string parameter to a number.
- *
- * @param value - String value to parse
- * @param options - Validation options
- * @returns Validation result containing the parsed number or error
- */
-export declare function parseNumberParam(value: string | undefined, options?: ValidationOptions): ValidationResult<number>;
-/**
- * Safely parses a string parameter to a boolean.
- *
- * @param value - String value to parse
- * @param options - Validation options
- * @returns Validation result containing the parsed boolean or error
- */
-export declare function parseBooleanParam(value: string | undefined, options?: ValidationOptions): ValidationResult<boolean>;
-/**
- * Extracts pagination parameters from request query parameters.
- *
- * @param query - Query parameters object
- * @param defaultPage - Default page number if not specified (defaults to 1)
- * @param defaultLimit - Default per page size if not specified (defaults to 20)
- * @param maxLimitSize - Maximum allowed per page size (defaults to 100)
- * @returns Object containing validated page and limit
- */
-export declare function extractPaginationParams(query: Record<string, string | string[]>, defaultPage?: number, defaultLimit?: number, maxLimitSize?: number): {
-    page: number;
-    limit: number;
-};
-/**
- * Extracts sorting parameters from request query parameters.
- *
- * @param query - Query parameters object
- * @param allowedFields - Array of field names that are allowed to be sorted
- * @param defaultSort - Default sort configuration if not specified
- * @returns Object containing sort field and direction
- */
-export declare function extractSortParams(query: Record<string, string | string[]>, allowedFields: string[], defaultSort?: {
-    sortBy: string;
-    sortOrder: 'asc' | 'desc';
-}): {
-    sortBy: string;
-    sortOrder: 'asc' | 'desc';
-};
-/**
- * Extracts filter parameters from query parameters based on allowed filter fields.
- *
- * @param query - Query parameters object
- * @param allowedFilters - Array of field names that are allowed to be used as filters
- * @returns Object containing the filters as key-value pairs
- */
-export declare function extractFilterParams(query: Record<string, string | string[]>, allowedFilters: string[]): Record<string, string | string[]>;