@catbee/utils 0.0.1

package/build/src/utils/obj.utils.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Checks whether the object has no own enumerable properties.
+ *
+ * @param {Record<any, any>} obj - The object to check.
+ * @returns {boolean} True if the object is empty, false otherwise.
+ */
+export declare const isObjEmpty: (obj: Record<any, any>) => boolean;
+/**
+ * Returns a new object with only the specified keys picked.
+ *
+ * @template T
+ * @template K
+ * @param {T} obj - The source object.
+ * @param {K[]} keys - Keys to pick from the object.
+ * @returns {Pick<T, K>} New object with picked keys.
+ */
+export declare const pick: <T extends object, K extends keyof T>(obj: T, keys: K[]) => Pick<T, K>;
+/**
+ * Returns a new object with the specified keys omitted.
+ *
+ * @template T
+ * @template K
+ * @param {T} obj - The source object.
+ * @param {K[]} keys - Keys to omit from the object.
+ * @returns {Omit<T, K>} New object without omitted keys.
+ */
+export declare const omit: <T extends object, K extends keyof T>(obj: T, keys: K[]) => Omit<T, K>;
+/**
+ * Deeply merges two objects (mutates and returns the target object, not pure).
+ *
+ * @template T
+ * @param {T} target - The object to merge into (will be mutated).
+ * @param {Partial<T>} source - The object to merge from.
+ * @returns {T} The merged object (same as target).
+ */
+export declare function deepObjMerge<T extends Record<string, any>>(target: T, source: Partial<T>): T;
+/**
+ * Flattens a nested object using dot notation for keys (e.g., `{a: {b: 1}}` → `{ "a.b": 1 }`).
+ *
+ * @template T
+ * @param {T} obj - The object to flatten.
+ * @param {string} [prefix=""] - Optional prefix for nested keys (used internally).
+ * @returns {Record<string, any>} A new object with flattened keys.
+ */
+export declare function flattenObject<T extends Record<string, any>>(obj: T, prefix?: string): Record<string, any>;
+/**
+ * Safely gets the value of a deeply nested key in an object using dot/bracket notation path.
+ *
+ * @template T
+ * @param {T} obj - The object to extract from.
+ * @param {string} path - String path using dot and/or bracket notation (e.g., 'user.friends[0].name').
+ * @returns {any} The value at the given path, or undefined if not found.
+ */
+export declare function getValueByPath<T extends object>(obj: T, path: string): any;
+//# sourceMappingURL=obj.utils.d.ts.map

package/build/src/utils/obj.utils.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.omit = exports.pick = exports.isObjEmpty = void 0;
+exports.deepObjMerge = deepObjMerge;
+exports.flattenObject = flattenObject;
+exports.getValueByPath = getValueByPath;
+/**
+ * Checks whether the object has no own enumerable properties.
+ *
+ * @param {Record<any, any>} obj - The object to check.
+ * @returns {boolean} True if the object is empty, false otherwise.
+ */
+const isObjEmpty = (obj) => !!obj && typeof obj === "object" && Object.keys(obj).length === 0;
+exports.isObjEmpty = isObjEmpty;
+/**
+ * Returns a new object with only the specified keys picked.
+ *
+ * @template T
+ * @template K
+ * @param {T} obj - The source object.
+ * @param {K[]} keys - Keys to pick from the object.
+ * @returns {Pick<T, K>} New object with picked keys.
+ */
+const pick = (obj, keys) => Object.fromEntries(keys.map((key) => [key, obj[key]]));
+exports.pick = pick;
+/**
+ * Returns a new object with the specified keys omitted.
+ *
+ * @template T
+ * @template K
+ * @param {T} obj - The source object.
+ * @param {K[]} keys - Keys to omit from the object.
+ * @returns {Omit<T, K>} New object without omitted keys.
+ */
+const omit = (obj, keys) => Object.fromEntries(Object.entries(obj).filter(([key]) => !keys.includes(key)));
+exports.omit = omit;
+/**
+ * Deeply merges two objects (mutates and returns the target object, not pure).
+ *
+ * @template T
+ * @param {T} target - The object to merge into (will be mutated).
+ * @param {Partial<T>} source - The object to merge from.
+ * @returns {T} The merged object (same as target).
+ */
+function deepObjMerge(target, source) {
+    for (const key in source) {
+        const sourceVal = source[key];
+        const targetVal = target[key];
+        if (sourceVal &&
+            typeof sourceVal === "object" &&
+            !Array.isArray(sourceVal)) {
+            if (!targetVal ||
+                typeof targetVal !== "object" ||
+                Array.isArray(targetVal)) {
+                target[key] = {};
+            }
+            deepObjMerge(target[key], sourceVal);
+        }
+        else {
+            target[key] = sourceVal;
+        }
+    }
+    return target;
+}
+/**
+ * Flattens a nested object using dot notation for keys (e.g., `{a: {b: 1}}` → `{ "a.b": 1 }`).
+ *
+ * @template T
+ * @param {T} obj - The object to flatten.
+ * @param {string} [prefix=""] - Optional prefix for nested keys (used internally).
+ * @returns {Record<string, any>} A new object with flattened keys.
+ */
+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;
+    }, {});
+}
+/**
+ * Safely gets the value of a deeply nested key in an object using dot/bracket notation path.
+ *
+ * @template T
+ * @param {T} obj - The object to extract from.
+ * @param {string} path - String path using dot and/or bracket notation (e.g., 'user.friends[0].name').
+ * @returns {any} The value at the given path, or undefined if not found.
+ */
+function getValueByPath(obj, path) {
+    if (!obj || typeof obj !== "object")
+        return undefined;
+    // Convert path like "a.b[0].c" into ["a", "b", "0", "c"]
+    const parts = path
+        .replace(/\[(\d+)\]/g, ".$1") // convert [0] to .0
+        .split(".")
+        .filter(Boolean); // remove empty strings
+    return parts.reduce((acc, key) => acc === null || acc === void 0 ? void 0 : acc[key], obj);
+}
+//# sourceMappingURL=obj.utils.js.map

package/build/src/utils/obj.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obj.utils.js","sourceRoot":"","sources":["../../../src/utils/obj.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Checks whether the object has no own enumerable properties.\n *\n * @param {Record<any, any>} obj - The object to check.\n * @returns {boolean} True if the object is empty, false otherwise.\n */\nexport const isObjEmpty = (obj: Record<any, any>): boolean =>\n  !!obj && typeof obj === \"object\" && Object.keys(obj).length === 0;\n\n/**\n * Returns a new object with only the specified keys picked.\n *\n * @template T\n * @template K\n * @param {T} obj - The source object.\n * @param {K[]} keys - Keys to pick from the object.\n * @returns {Pick<T, K>} New object with picked keys.\n */\nexport const pick = <T extends object, K extends keyof T>(\n  obj: T,\n  keys: K[],\n): Pick<T, K> =>\n  Object.fromEntries(keys.map((key) => [key, obj[key]])) as Pick<T, K>;\n\n/**\n * Returns a new object with the specified keys omitted.\n *\n * @template T\n * @template K\n * @param {T} obj - The source object.\n * @param {K[]} keys - Keys to omit from the object.\n * @returns {Omit<T, K>} New object without omitted keys.\n */\nexport const omit = <T extends object, K extends keyof T>(\n  obj: T,\n  keys: K[],\n): Omit<T, K> =>\n  Object.fromEntries(\n    Object.entries(obj).filter(([key]) => !keys.includes(key as K)),\n  ) as Omit<T, K>;\n\n/**\n * Deeply merges two objects (mutates and returns the target object, not pure).\n *\n * @template T\n * @param {T} target - The object to merge into (will be mutated).\n * @param {Partial<T>} source - The object to merge from.\n * @returns {T} The merged object (same as target).\n */\nexport function deepObjMerge<T extends Record<string, any>>(\n  target: T,\n  source: Partial<T>,\n): T {\n  for (const key in source) {\n    const sourceVal = source[key];\n    const targetVal = target[key];\n\n    if (\n      sourceVal &&\n      typeof sourceVal === \"object\" &&\n      !Array.isArray(sourceVal)\n    ) {\n      if (\n        !targetVal ||\n        typeof targetVal !== \"object\" ||\n        Array.isArray(targetVal)\n      ) {\n        target[key] = {} as any;\n      }\n      deepObjMerge(target[key], sourceVal as any);\n    } else {\n      target[key] = sourceVal as T[Extract<keyof T, string>];\n    }\n  }\n  return target;\n}\n\n/**\n * Flattens a nested object using dot notation for keys (e.g., `{a: {b: 1}}` → `{ \"a.b\": 1 }`).\n *\n * @template T\n * @param {T} obj - The object to flatten.\n * @param {string} [prefix=\"\"] - Optional prefix for nested keys (used internally).\n * @returns {Record<string, any>} A new object with flattened keys.\n */\nexport function flattenObject<T extends Record<string, any>>(\n  obj: T,\n  prefix = \"\",\n): Record<string, any> {\n  return Object.entries(obj).reduce(\n    (acc: Record<string, any>, [key, value]) => {\n      const newKey = prefix ? `${prefix}.${key}` : key;\n\n      if (value && typeof value === \"object\" && !Array.isArray(value)) {\n        Object.assign(acc, flattenObject(value, newKey));\n      } else {\n        acc[newKey] = value;\n      }\n\n      return acc;\n    },\n    {},\n  );\n}\n\n/**\n * Safely gets the value of a deeply nested key in an object using dot/bracket notation path.\n *\n * @template T\n * @param {T} obj - The object to extract from.\n * @param {string} path - String path using dot and/or bracket notation (e.g., 'user.friends[0].name').\n * @returns {any} The value at the given path, or undefined if not found.\n */\nexport function getValueByPath<T extends object>(obj: T, path: string) {\n  if (!obj || typeof obj !== \"object\") return undefined;\n\n  // Convert path like \"a.b[0].c\" into [\"a\", \"b\", \"0\", \"c\"]\n  const parts = path\n    .replace(/\\[(\\d+)\\]/g, \".$1\") // convert [0] to .0\n    .split(\".\")\n    .filter(Boolean); // remove empty strings\n\n  return parts.reduce((acc: any, key: string) => acc?.[key], obj);\n}\n"]}

package/build/src/utils/response.utils.d.ts

@@ -0,0 +1,48 @@
+import { ApiResponse } from "../types/api-response";
+/**
+ * Standard HTTP response wrapper for successful responses.
+ * Implements the `ApiResponse<T>` interface and sets default values.
+ *
+ * @typeParam T - The shape of the data returned in the response.
+ */
+export declare class SuccessResponse<T> implements ApiResponse<T> {
+    /** Message describing the result of the operation. */
+    message: string;
+    /** Whether the response is an error. Always false in success responses. */
+    error: boolean;
+    /** The payload returned from the API. */
+    data: T | null;
+    /** Timestamp when the response was generated, in ISO format. */
+    timestamp: string;
+    /** Unique identifier for this response, useful for request tracing. */
+    requestId: string;
+    /**
+     * Constructs a new success response.
+     *
+     * @param {string} message - Optional message to override the default.
+     * @param {T} [data] - Optional data payload.
+     */
+    constructor(message: string, data?: T);
+}
+/**
+ * Wrapper for error responses that extends the native `Error` object.
+ * Implements `ApiResponse` but omits the `data` field (which should not be present in errors).
+ */
+export declare class ErrorResponse extends Error implements Omit<ApiResponse<never>, "data"> {
+    /** HTTP status code associated with the error (e.g., 404, 500). */
+    status: number;
+    /** Indicates that this is an error. Always true. */
+    error: boolean;
+    /** Timestamp when the error occurred, in ISO format. */
+    timestamp: string;
+    /** Unique identifier for this error instance. */
+    requestId: string;
+    /**
+     * Constructs a new error response.
+     *
+     * @param {string} message - The error message to display or log.
+     * @param {number} [status=500] - Optional HTTP status code (defaults to 500).
+     */
+    constructor(message: string, status?: number);
+}
+//# sourceMappingURL=response.utils.d.ts.map

package/build/src/utils/response.utils.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorResponse = exports.SuccessResponse = void 0;
+const crypto_1 = require("crypto");
+const context_store_utils_1 = require("./context-store.utils");
+/**
+ * Standard HTTP response wrapper for successful responses.
+ * Implements the `ApiResponse<T>` interface and sets default values.
+ *
+ * @typeParam T - The shape of the data returned in the response.
+ */
+class SuccessResponse {
+    /**
+     * Constructs a new success response.
+     *
+     * @param {string} message - Optional message to override the default.
+     * @param {T} [data] - Optional data payload.
+     */
+    constructor(message, data) {
+        var _a;
+        /** Message describing the result of the operation. */
+        this.message = "Success";
+        /** Whether the response is an error. Always false in success responses. */
+        this.error = false;
+        /** The payload returned from the API. */
+        this.data = null;
+        /** Timestamp when the response was generated, in ISO format. */
+        this.timestamp = new Date().toISOString();
+        /** Unique identifier for this response, useful for request tracing. */
+        this.requestId = (_a = (0, context_store_utils_1.getRequestId)()) !== null && _a !== void 0 ? _a : (0, crypto_1.randomUUID)();
+        if (message)
+            this.message = message;
+        this.data = data !== null && data !== void 0 ? data : null;
+    }
+}
+exports.SuccessResponse = SuccessResponse;
+/**
+ * Wrapper for error responses that extends the native `Error` object.
+ * Implements `ApiResponse` but omits the `data` field (which should not be present in errors).
+ */
+class ErrorResponse extends Error {
+    /**
+     * Constructs a new error response.
+     *
+     * @param {string} message - The error message to display or log.
+     * @param {number} [status=500] - Optional HTTP status code (defaults to 500).
+     */
+    constructor(message, status = 500) {
+        var _a;
+        super(message);
+        /** Indicates that this is an error. Always true. */
+        this.error = true;
+        /** Timestamp when the error occurred, in ISO format. */
+        this.timestamp = new Date().toISOString();
+        /** Unique identifier for this error instance. */
+        this.requestId = (_a = (0, context_store_utils_1.getRequestId)()) !== null && _a !== void 0 ? _a : (0, crypto_1.randomUUID)();
+        this.status = status;
+        this.name = this.constructor.name;
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+exports.ErrorResponse = ErrorResponse;
+//# sourceMappingURL=response.utils.js.map

package/build/src/utils/response.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.utils.js","sourceRoot":"","sources":["../../../src/utils/response.utils.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AAEpC,+DAAqD;AAErD;;;;;GAKG;AACH,MAAa,eAAe;IAgB1B;;;;;OAKG;IACH,YAAY,OAAe,EAAE,IAAQ;;QArBrC,sDAAsD;QACtD,YAAO,GAAW,SAAS,CAAC;QAE5B,2EAA2E;QAC3E,UAAK,GAAY,KAAK,CAAC;QAEvB,yCAAyC;QACzC,SAAI,GAAa,IAAI,CAAC;QAEtB,gEAAgE;QAChE,cAAS,GAAW,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE7C,uEAAuE;QACvE,cAAS,GAAW,MAAA,IAAA,kCAAY,GAAE,mCAAI,IAAA,mBAAU,GAAE,CAAC;QASjD,IAAI,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,IAAI,CAAC;IAC3B,CAAC;CACF;AA1BD,0CA0BC;AAED;;;GAGG;AACH,MAAa,aACX,SAAQ,KAAK;IAeb;;;;;OAKG;IACH,YAAY,OAAe,EAAE,SAAiB,GAAG;;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QAhBjB,oDAAoD;QACpD,UAAK,GAAY,IAAI,CAAC;QAEtB,wDAAwD;QACxD,cAAS,GAAW,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE7C,iDAAiD;QACjD,cAAS,GAAW,MAAA,IAAA,kCAAY,GAAE,mCAAI,IAAA,mBAAU,GAAE,CAAC;QAUjD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AA5BD,sCA4BC","sourcesContent":["import { randomUUID } from \"crypto\";\nimport { ApiResponse } from \"../types/api-response\";\nimport { getRequestId } from \"./context-store.utils\";\n\n/**\n * Standard HTTP response wrapper for successful responses.\n * Implements the `ApiResponse<T>` interface and sets default values.\n *\n * @typeParam T - The shape of the data returned in the response.\n */\nexport class SuccessResponse<T> implements ApiResponse<T> {\n  /** Message describing the result of the operation. */\n  message: string = \"Success\";\n\n  /** Whether the response is an error. Always false in success responses. */\n  error: boolean = false;\n\n  /** The payload returned from the API. */\n  data: T | null = null;\n\n  /** Timestamp when the response was generated, in ISO format. */\n  timestamp: string = new Date().toISOString();\n\n  /** Unique identifier for this response, useful for request tracing. */\n  requestId: string = getRequestId() ?? randomUUID();\n\n  /**\n   * Constructs a new success response.\n   *\n   * @param {string} message - Optional message to override the default.\n   * @param {T} [data] - Optional data payload.\n   */\n  constructor(message: string, data?: T) {\n    if (message) this.message = message;\n    this.data = data ?? null;\n  }\n}\n\n/**\n * Wrapper for error responses that extends the native `Error` object.\n * Implements `ApiResponse` but omits the `data` field (which should not be present in errors).\n */\nexport class ErrorResponse\n  extends Error\n  implements Omit<ApiResponse<never>, \"data\">\n{\n  /** HTTP status code associated with the error (e.g., 404, 500). */\n  status: number;\n\n  /** Indicates that this is an error. Always true. */\n  error: boolean = true;\n\n  /** Timestamp when the error occurred, in ISO format. */\n  timestamp: string = new Date().toISOString();\n\n  /** Unique identifier for this error instance. */\n  requestId: string = getRequestId() ?? randomUUID();\n\n  /**\n   * Constructs a new error response.\n   *\n   * @param {string} message - The error message to display or log.\n   * @param {number} [status=500] - Optional HTTP status code (defaults to 500).\n   */\n  constructor(message: string, status: number = 500) {\n    super(message);\n    this.status = status;\n    this.name = this.constructor.name;\n    Error.captureStackTrace(this, this.constructor);\n  }\n}\n"]}

package/build/src/utils/string.utils.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Capitalizes the first character of a string.
+ *
+ * @param {string} str - The input string.
+ * @returns {string} The string with the first character in uppercase.
+ */
+export declare const capitalize: (str: string) => string;
+/**
+ * Converts a string to kebab-case (e.g., "FooBar test" → "foo-bar-test").
+ *
+ * @param {string} str - The input string.
+ * @returns {string} The kebab-cased string.
+ */
+export declare const toKebabCase: (str: string) => string;
+/**
+ * Converts a kebab-case or snake_case string to camelCase.
+ *
+ * @param {string} str - The input string.
+ * @returns {string} The camelCased string.
+ */
+export declare const toCamelCase: (str: string) => string;
+/**
+ * Converts a string to a URL-friendly slug (lowercase, dashes, alphanumeric).
+ *
+ * @param {string} str - The input string.
+ * @returns {string} The slugified string.
+ */
+export declare const slugify: (str: string) => string;
+/**
+ * Truncates a string to a specific length, appending '...' if truncated.
+ *
+ * @param {string} str - The input string.
+ * @param {number} len - The maximum length.
+ * @returns {string} The truncated string.
+ */
+export declare const truncate: (str: string, len: number) => string;
+//# sourceMappingURL=string.utils.d.ts.map

package/build/src/utils/string.utils.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.truncate = exports.slugify = exports.toCamelCase = exports.toKebabCase = exports.capitalize = void 0;
+/**
+ * Capitalizes the first character of a string.
+ *
+ * @param {string} str - The input string.
+ * @returns {string} The string with the first character in uppercase.
+ */
+const capitalize = (str) => str.length === 0 ? "" : str.charAt(0).toUpperCase() + str.slice(1);
+exports.capitalize = capitalize;
+/**
+ * Converts a string to kebab-case (e.g., "FooBar test" → "foo-bar-test").
+ *
+ * @param {string} str - The input string.
+ * @returns {string} The kebab-cased string.
+ */
+const toKebabCase = (str) => str
+    .replace(/([a-z])([A-Z])/g, "$1-$2") // camelCase -> camel-Case
+    .replace(/\s+/g, "-") // spaces to dash
+    .replace(/_+/g, "-") // underscores to dash
+    .toLowerCase();
+exports.toKebabCase = toKebabCase;
+/**
+ * Converts a kebab-case or snake_case string to camelCase.
+ *
+ * @param {string} str - The input string.
+ * @returns {string} The camelCased string.
+ */
+const toCamelCase = (str) => str.replace(/[-_](.)/g, (_, c) => c.toUpperCase());
+exports.toCamelCase = toCamelCase;
+/**
+ * Converts a string to a URL-friendly slug (lowercase, dashes, alphanumeric).
+ *
+ * @param {string} str - The input string.
+ * @returns {string} The slugified string.
+ */
+const slugify = (str) => str
+    .toLowerCase()
+    .replace(/[^\w\s-]/g, "") // remove non-word
+    .replace(/\s+/g, "-") // spaces to dash
+    .replace(/-+/g, "-") // multiple dashes to one
+    .replace(/^-+|-+$/g, ""); // trim leading/trailing dashes
+exports.slugify = slugify;
+/**
+ * Truncates a string to a specific length, appending '...' if truncated.
+ *
+ * @param {string} str - The input string.
+ * @param {number} len - The maximum length.
+ * @returns {string} The truncated string.
+ */
+const truncate = (str, len) => str.length > len ? str.slice(0, len) + "..." : str;
+exports.truncate = truncate;
+//# sourceMappingURL=string.utils.js.map

package/build/src/utils/string.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.utils.js","sourceRoot":"","sources":["../../../src/utils/string.utils.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACI,MAAM,UAAU,GAAG,CAAC,GAAW,EAAU,EAAE,CAChD,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AADxD,QAAA,UAAU,cAC8C;AAErE;;;;;GAKG;AACI,MAAM,WAAW,GAAG,CAAC,GAAW,EAAU,EAAE,CACjD,GAAG;KACA,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,0BAA0B;KAC9D,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,iBAAiB;KACtC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,sBAAsB;KAC1C,WAAW,EAAE,CAAC;AALN,QAAA,WAAW,eAKL;AAEnB;;;;;GAKG;AACI,MAAM,WAAW,GAAG,CAAC,GAAW,EAAU,EAAE,CACjD,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AADhD,QAAA,WAAW,eACqC;AAE7D;;;;;GAKG;AACI,MAAM,OAAO,GAAG,CAAC,GAAW,EAAU,EAAE,CAC7C,GAAG;KACA,WAAW,EAAE;KACb,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,kBAAkB;KAC3C,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,iBAAiB;KACtC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,yBAAyB;KAC7C,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,+BAA+B;AANhD,QAAA,OAAO,WAMS;AAE7B;;;;;;GAMG;AACI,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,GAAW,EAAU,EAAE,CAC3D,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;AADxC,QAAA,QAAQ,YACgC","sourcesContent":["/**\n * Capitalizes the first character of a string.\n *\n * @param {string} str - The input string.\n * @returns {string} The string with the first character in uppercase.\n */\nexport const capitalize = (str: string): string =>\n  str.length === 0 ? \"\" : str.charAt(0).toUpperCase() + str.slice(1);\n\n/**\n * Converts a string to kebab-case (e.g., \"FooBar test\" → \"foo-bar-test\").\n *\n * @param {string} str - The input string.\n * @returns {string} The kebab-cased string.\n */\nexport const toKebabCase = (str: string): string =>\n  str\n    .replace(/([a-z])([A-Z])/g, \"$1-$2\") // camelCase -> camel-Case\n    .replace(/\\s+/g, \"-\") // spaces to dash\n    .replace(/_+/g, \"-\") // underscores to dash\n    .toLowerCase();\n\n/**\n * Converts a kebab-case or snake_case string to camelCase.\n *\n * @param {string} str - The input string.\n * @returns {string} The camelCased string.\n */\nexport const toCamelCase = (str: string): string =>\n  str.replace(/[-_](.)/g, (_, c: string) => c.toUpperCase());\n\n/**\n * Converts a string to a URL-friendly slug (lowercase, dashes, alphanumeric).\n *\n * @param {string} str - The input string.\n * @returns {string} The slugified string.\n */\nexport const slugify = (str: string): string =>\n  str\n    .toLowerCase()\n    .replace(/[^\\w\\s-]/g, \"\") // remove non-word\n    .replace(/\\s+/g, \"-\") // spaces to dash\n    .replace(/-+/g, \"-\") // multiple dashes to one\n    .replace(/^-+|-+$/g, \"\"); // trim leading/trailing dashes\n\n/**\n * Truncates a string to a specific length, appending '...' if truncated.\n *\n * @param {string} str - The input string.\n * @param {number} len - The maximum length.\n * @returns {string} The truncated string.\n */\nexport const truncate = (str: string, len: number): string =>\n  str.length > len ? str.slice(0, len) + \"...\" : str;\n"]}

package/build/src/utils/url.utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Appends query parameters to a given URL.
+ *
+ * @param {string} url - The base URL to which query parameters will be appended.
+ * @param {Record<string, string | number>} params - Key-value pairs to add as query parameters.
+ * @returns {string} The new URL string with query parameters appended.
+ *
+ * @example
+ * appendQueryParams('https://example.com', { page: 1, limit: 10 });
+ * // → 'https://example.com/?page=1&limit=10'
+ */
+export declare function appendQueryParams(url: string, params: Record<string, string | number>): string;
+/**
+ * Parses a query string into a key-value object.
+ *
+ * @param {string} query - The query string (with or without leading '?').
+ * @returns {Record<string, string>} Object representing parsed query parameters.
+ *
+ * @example
+ * parseQueryString('?page=1&limit=10');
+ * // → { page: '1', limit: '10' }
+ */
+export declare function parseQueryString(query: string): Record<string, string>;
+//# sourceMappingURL=url.utils.d.ts.map

package/build/src/utils/url.utils.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appendQueryParams = appendQueryParams;
+exports.parseQueryString = parseQueryString;
+const url_1 = require("url");
+/**
+ * Appends query parameters to a given URL.
+ *
+ * @param {string} url - The base URL to which query parameters will be appended.
+ * @param {Record<string, string | number>} params - Key-value pairs to add as query parameters.
+ * @returns {string} The new URL string with query parameters appended.
+ *
+ * @example
+ * appendQueryParams('https://example.com', { page: 1, limit: 10 });
+ * // → 'https://example.com/?page=1&limit=10'
+ */
+function appendQueryParams(url, params) {
+    const urlObj = new url_1.URL(url);
+    for (const [key, value] of Object.entries(params)) {
+        urlObj.searchParams.set(key, value.toString());
+    }
+    return urlObj.toString();
+}
+/**
+ * Parses a query string into a key-value object.
+ *
+ * @param {string} query - The query string (with or without leading '?').
+ * @returns {Record<string, string>} Object representing parsed query parameters.
+ *
+ * @example
+ * parseQueryString('?page=1&limit=10');
+ * // → { page: '1', limit: '10' }
+ */
+function parseQueryString(query) {
+    const cleanQuery = query.startsWith("?") ? query.slice(1) : query;
+    // Object.fromEntries guarantees string values in result
+    return Object.fromEntries(new url_1.URLSearchParams(cleanQuery));
+}
+//# sourceMappingURL=url.utils.js.map

package/build/src/utils/url.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.utils.js","sourceRoot":"","sources":["../../../src/utils/url.utils.ts"],"names":[],"mappings":";;AAaA,8CASC;AAYD,4CAOC;AAzCD,6BAA2C;AAE3C;;;;;;;;;;GAUG;AACH,SAAgB,iBAAiB,CAC/B,GAAW,EACX,MAAuC;IAEvC,MAAM,MAAM,GAAG,IAAI,SAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,gBAAgB,CAAC,KAAa;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAClE,wDAAwD;IACxD,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,qBAAe,CAAC,UAAU,CAAC,CAGxD,CAAC;AACJ,CAAC","sourcesContent":["import { URL, URLSearchParams } from \"url\";\n\n/**\n * Appends query parameters to a given URL.\n *\n * @param {string} url - The base URL to which query parameters will be appended.\n * @param {Record<string, string | number>} params - Key-value pairs to add as query parameters.\n * @returns {string} The new URL string with query parameters appended.\n *\n * @example\n * appendQueryParams('https://example.com', { page: 1, limit: 10 });\n * // → 'https://example.com/?page=1&limit=10'\n */\nexport function appendQueryParams(\n  url: string,\n  params: Record<string, string | number>,\n): string {\n  const urlObj = new URL(url);\n  for (const [key, value] of Object.entries(params)) {\n    urlObj.searchParams.set(key, value.toString());\n  }\n  return urlObj.toString();\n}\n\n/**\n * Parses a query string into a key-value object.\n *\n * @param {string} query - The query string (with or without leading '?').\n * @returns {Record<string, string>} Object representing parsed query parameters.\n *\n * @example\n * parseQueryString('?page=1&limit=10');\n * // → { page: '1', limit: '10' }\n */\nexport function parseQueryString(query: string): Record<string, string> {\n  const cleanQuery = query.startsWith(\"?\") ? query.slice(1) : query;\n  // Object.fromEntries guarantees string values in result\n  return Object.fromEntries(new URLSearchParams(cleanQuery)) as Record<\n    string,\n    string\n  >;\n}\n"]}

package/build/src/utils/validate.utils.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Collection of common validation helpers for strings, numbers, email, UUID, etc.
+ */
+/**
+ * Checks if a string is a valid email address.
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if valid email, else false.
+ */
+export declare function isEmail(str: string): boolean;
+/**
+ * Checks if a string is a valid UUID (versions 1-5).
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if valid UUID, else false.
+ */
+export declare function isUUID(str: string): boolean;
+/**
+ * Checks if a string is a valid URL.
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if valid URL, else false.
+ */
+export declare function isURL(str: string): boolean;
+/**
+ * Checks if a string is a valid international phone number (E.164 or common patterns).
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if looks like a phone number.
+ */
+export declare function isPhone(str: string): boolean;
+/**
+ * Checks if a string is strictly alphanumeric (letters/numbers only).
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if alphanumeric.
+ */
+export declare function isAlphanumeric(str: string): boolean;
+/**
+ * Checks if a string or number can be safely parsed to a number.
+ *
+ * @param {string | number} value - The value to check.
+ * @returns {boolean} True if the value is numeric.
+ */
+export declare function isNumeric(value: string | number): boolean;
+/**
+ * Checks if a string is a valid hex color code (e.g. #FFF or #FFFFFF).
+ *
+ * @param {string} str - Input string.
+ * @returns {boolean}
+ */
+export declare function isHexColor(str: string): boolean;
+/**
+ * Checks if a string is a valid date string.
+ *
+ * @param {string} str - Input string.
+ * @returns {boolean}
+ */
+export declare function isISODate(str: string): boolean;
+//# sourceMappingURL=validate.utils.d.ts.map

package/build/src/utils/validate.utils.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * Collection of common validation helpers for strings, numbers, email, UUID, etc.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEmail = isEmail;
+exports.isUUID = isUUID;
+exports.isURL = isURL;
+exports.isPhone = isPhone;
+exports.isAlphanumeric = isAlphanumeric;
+exports.isNumeric = isNumeric;
+exports.isHexColor = isHexColor;
+exports.isISODate = isISODate;
+/**
+ * Checks if a string is a valid email address.
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if valid email, else false.
+ */
+function isEmail(str) {
+    if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(str))
+        return false;
+    // Additional checks
+    const [local, domain] = str.split("@");
+    if (!local || !domain)
+        return false;
+    // Disallow consecutive dots in local or domain part
+    if (local.includes("..") || domain.includes(".."))
+        return false;
+    return true;
+}
+/**
+ * Checks if a string is a valid UUID (versions 1-5).
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if valid UUID, else false.
+ */
+function isUUID(str) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(str);
+}
+/**
+ * Checks if a string is a valid URL.
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if valid URL, else false.
+ */
+function isURL(str) {
+    try {
+        new URL(str);
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Checks if a string is a valid international phone number (E.164 or common patterns).
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if looks like a phone number.
+ */
+function isPhone(str) {
+    if (typeof str !== "string")
+        return false;
+    // Strip non-digit characters to count total digits
+    const digitsOnly = str.replace(/\D/g, "");
+    if (digitsOnly.length < 6 || digitsOnly.length > 15)
+        return false;
+    // Accept typical phone characters: +, digits, space, -, (, )
+    return /^[+]?[\d\s().-]+$/.test(str);
+}
+/**
+ * Checks if a string is strictly alphanumeric (letters/numbers only).
+ *
+ * @param {string} str - The input string.
+ * @returns {boolean} True if alphanumeric.
+ */
+function isAlphanumeric(str) {
+    return /^[a-z0-9]+$/i.test(str);
+}
+/**
+ * Checks if a string or number can be safely parsed to a number.
+ *
+ * @param {string | number} value - The value to check.
+ * @returns {boolean} True if the value is numeric.
+ */
+function isNumeric(value) {
+    if (typeof value === "string" && value.trim() === "")
+        return false;
+    const num = typeof value === "number" ? value : Number(value);
+    return typeof num === "number" && isFinite(num);
+}
+/**
+ * Checks if a string is a valid hex color code (e.g. #FFF or #FFFFFF).
+ *
+ * @param {string} str - Input string.
+ * @returns {boolean}
+ */
+function isHexColor(str) {
+    return /^#([a-f0-9]{6}|[a-f0-9]{3})$/i.test(str);
+}
+/**
+ * Checks if a string is a valid date string.
+ *
+ * @param {string} str - Input string.
+ * @returns {boolean}
+ */
+function isISODate(str) {
+    const isoRegex = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?)?$/;
+    if (!isoRegex.test(str))
+        return false;
+    const date = new Date(str);
+    return (!isNaN(date.getTime()) && date.toISOString().startsWith(str.slice(0, 10)));
+}
+//# sourceMappingURL=validate.utils.js.map

package/build/src/utils/validate.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.utils.js","sourceRoot":"","sources":["../../../src/utils/validate.utils.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAQH,0BAWC;AAQD,wBAIC;AAQD,sBAOC;AAQD,0BASC;AAQD,wCAEC;AAQD,8BAIC;AAQD,gCAEC;AAQD,8BAUC;AA/GD;;;;;GAKG;AACH,SAAgB,OAAO,CAAC,GAAW;IACjC,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1D,oBAAoB;IACpB,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAEpC,oDAAoD;IACpD,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAEhE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAgB,MAAM,CAAC,GAAW;IAChC,OAAO,4EAA4E,CAAC,IAAI,CACtF,GAAG,CACJ,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,KAAK,CAAC,GAAW;IAC/B,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,OAAO,CAAC,GAAW;IACjC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE1C,mDAAmD;IACnD,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IAElE,6DAA6D;IAC7D,OAAO,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,GAAW;IACxC,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,KAAsB;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACnE,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9D,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,GAAW;IACpC,OAAO,+BAA+B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,GAAW;IACnC,MAAM,QAAQ,GACZ,sEAAsE,CAAC;IAEzE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,CACL,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAC1E,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Collection of common validation helpers for strings, numbers, email, UUID, etc.\n */\n\n/**\n * Checks if a string is a valid email address.\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if valid email, else false.\n */\nexport function isEmail(str: string): boolean {\n  if (!/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(str)) return false;\n\n  // Additional checks\n  const [local, domain] = str.split(\"@\");\n  if (!local || !domain) return false;\n\n  // Disallow consecutive dots in local or domain part\n  if (local.includes(\"..\") || domain.includes(\"..\")) return false;\n\n  return true;\n}\n\n/**\n * Checks if a string is a valid UUID (versions 1-5).\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if valid UUID, else false.\n */\nexport function isUUID(str: string): boolean {\n  return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(\n    str,\n  );\n}\n\n/**\n * Checks if a string is a valid URL.\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if valid URL, else false.\n */\nexport function isURL(str: string): boolean {\n  try {\n    new URL(str);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Checks if a string is a valid international phone number (E.164 or common patterns).\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if looks like a phone number.\n */\nexport function isPhone(str: string): boolean {\n  if (typeof str !== \"string\") return false;\n\n  // Strip non-digit characters to count total digits\n  const digitsOnly = str.replace(/\\D/g, \"\");\n  if (digitsOnly.length < 6 || digitsOnly.length > 15) return false;\n\n  // Accept typical phone characters: +, digits, space, -, (, )\n  return /^[+]?[\\d\\s().-]+$/.test(str);\n}\n\n/**\n * Checks if a string is strictly alphanumeric (letters/numbers only).\n *\n * @param {string} str - The input string.\n * @returns {boolean} True if alphanumeric.\n */\nexport function isAlphanumeric(str: string): boolean {\n  return /^[a-z0-9]+$/i.test(str);\n}\n\n/**\n * Checks if a string or number can be safely parsed to a number.\n *\n * @param {string | number} value - The value to check.\n * @returns {boolean} True if the value is numeric.\n */\nexport function isNumeric(value: string | number): boolean {\n  if (typeof value === \"string\" && value.trim() === \"\") return false;\n  const num = typeof value === \"number\" ? value : Number(value);\n  return typeof num === \"number\" && isFinite(num);\n}\n\n/**\n * Checks if a string is a valid hex color code (e.g. #FFF or #FFFFFF).\n *\n * @param {string} str - Input string.\n * @returns {boolean}\n */\nexport function isHexColor(str: string): boolean {\n  return /^#([a-f0-9]{6}|[a-f0-9]{3})$/i.test(str);\n}\n\n/**\n * Checks if a string is a valid date string.\n *\n * @param {string} str - Input string.\n * @returns {boolean}\n */\nexport function isISODate(str: string): boolean {\n  const isoRegex =\n    /^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})?)?$/;\n\n  if (!isoRegex.test(str)) return false;\n\n  const date = new Date(str);\n  return (\n    !isNaN(date.getTime()) && date.toISOString().startsWith(str.slice(0, 10))\n  );\n}\n"]}