fiberx-backend-toolkit 0.1.21 → 1.0.1

package/dist/storage/utils/storage_driver_util.js

@@ -10,7 +10,9 @@ const local_storage_driver_1 = __importDefault(require("../../storage/drivers/lo
 class StorageDriverUtil {
     static instance = null;
     static logger = new main_1.LoggerUtil("storage_driver_util");
-    static env_manager = main_1.EnvManagerUtil.getInstance();
+    static get env_manager() {
+        return main_1.EnvManagerUtil.getInstance();
+    }
     /**
      * Get initialized storage driver (singleton)
      */
@@ -42,9 +44,12 @@ class StorageDriverUtil {
             if (main_1.InputValidatorUtil.isLive()) {
                 const driver_type = StorageDriverUtil.env_manager.getEnvVar(constants_1.FILE_UPLOAD_ENV_KEYS.STORAGE_DRIVER_NAME, "");
                 switch (driver_type?.toLowerCase()) {
-                    case "local": return StorageDriverUtil.initLocalDriver();
-                    case "gcs": return await StorageDriverUtil.initGCSDriver();
-                    default: throw new Error(`Unsupported storage driver type '${driver_type}' in live environment`);
+                    case "local":
+                        return StorageDriverUtil.initLocalDriver();
+                    case "gcs":
+                        return await StorageDriverUtil.initGCSDriver();
+                    default:
+                        throw new Error(`Unsupported storage driver type '${driver_type}' in live environment`);
                 }
             }
             throw new Error("Unsupported environment for storage driver");
@@ -66,7 +71,7 @@ class StorageDriverUtil {
         const config = {
             type: "local",
             base_dir,
-            public_base_url
+            public_base_url,
         };
         const driver = new local_storage_driver_1.default();
         await driver.initialize(config);
@@ -79,23 +84,20 @@ class StorageDriverUtil {
     static async initGCSDriver() {
         const project_id = StorageDriverUtil.env_manager.getEnvVar(constants_1.FILE_UPLOAD_ENV_KEYS.GCS_PROJECT_ID, "");
         const bucket_name = StorageDriverUtil.env_manager.getEnvVar(constants_1.FILE_UPLOAD_ENV_KEYS.GCS_BUCKET_NAME, "");
-        ;
         const client_email = StorageDriverUtil.env_manager.getEnvVar(constants_1.FILE_UPLOAD_ENV_KEYS.GCS_CLIENT_EMAIL, "");
-        ;
         const private_key = StorageDriverUtil.env_manager.getEnvVar(constants_1.FILE_UPLOAD_ENV_KEYS.GCS_PRIVATE_KEY, "");
-        ;
         if (!project_id || !bucket_name || !client_email || !private_key) {
             throw new Error("Missing required GCS environment variables");
         }
         const credentials = {
             client_email,
-            private_key: private_key.replace(/\\n/g, "\n")
+            private_key: private_key.replace(/\\n/g, "\n"),
         };
         const config = {
             type: "gcs",
             project_id,
             bucket_name,
-            credentials
+            credentials,
         };
         const driver = new gcs_storage_driver_1.default();
         await driver.initialize(config);

package/dist/types/express_decelaration.d.ts

@@ -1,4 +1,3 @@
-import "express-serve-static-core";
 declare module "express-serve-static-core" {
     interface Response {
         errResponse: (code?: number, msg?: string, data?: any) => Response;
@@ -17,3 +16,4 @@ declare module "express-serve-static-core" {
         clientIp?: string;
     }
 }
+export {};

package/dist/types/express_decelaration.js

@@ -1,3 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-require("express-serve-static-core");

package/dist/types/middle_ware_type.d.ts

@@ -65,6 +65,7 @@ export interface DefaultRequestInfo {
     device_id?: string;
     origin_url: string;
     request_id: string;
+    permission_name?: string;
 }
 export interface DefaultAccessTokenPayload {
     type: string;
@@ -79,16 +80,17 @@ export interface DefaultRefreshTokenPayload {
     device_id: string;
 }
 export interface AuthenticatorOptions<TRequestInfo extends DefaultRequestInfo = DefaultRequestInfo, TAccessPayload extends DefaultAccessTokenPayload = DefaultAccessTokenPayload, TRefreshPayload extends DefaultRefreshTokenPayload = DefaultRefreshTokenPayload, TSessionModel extends Model = Model, TLoginChallengeModel extends Model = Model, TActorModel extends Model = Model> {
-    extractRequestInfoMethod: (req: Request) => Promise<TRequestInfo | null>;
-    validateAccessTokenMethod: (access_token: string, requestInfo?: TRequestInfo) => Promise<TAccessPayload | null>;
-    validateRefreshTokenMethod: (refresh_token: string, requestInfo?: TRequestInfo) => Promise<TRefreshPayload | null>;
-    loadActorMethod(actor_type: string, actor_id: number | string, requestInfo?: TRequestInfo): Promise<TActorModel | null>;
-    loadMemberSessionMethod(member_id: number | string, session_id: number | string, request_info?: TRequestInfo, is_2fa_validated?: boolean): Promise<TSessionModel | null>;
-    loadMemberLoginChallenegeMethod(member_id: number | string, challenge_id: number | string, request_info?: TRequestInfo, is_2fa_validated?: boolean): Promise<TLoginChallengeModel | null>;
-    getActorPermissionsMethod(actor_id: number | string, role_ids: (number | string)[]): Promise<string[]>;
-    validateActorHasPermissionMethod(request_info: TRequestInfo): Promise<boolean>;
-    requireNoAuthMiddleWareMethod(req: Request, res: Response, next: NextFunction): Promise<void | Response>;
-    requirePartialAuthMiddleWareMethod(req: Request, res: Response, next: NextFunction): Promise<void | Response>;
-    requireFullAuthMiddleWareMethod(req: Request, res: Response, next: NextFunction): Promise<void | Response>;
-    requireAppAuthMiddleWareMethod(req: Request, res: Response, next: NextFunction): Promise<void | Response>;
+    extractRequestInfoMethod?: (req: Request) => Promise<TRequestInfo | null>;
+    validateAccessTokenMethod?: (access_token: string, requestInfo?: TRequestInfo) => Promise<TAccessPayload | null>;
+    validateRefreshTokenMethod?: (refresh_token: string, requestInfo?: TRequestInfo) => Promise<TRefreshPayload | null>;
+    loadActorMethod?(actor_type: string, actor_id: number | string, requestInfo?: TRequestInfo): Promise<TActorModel | null>;
+    loadMemberSessionMethod?(member_id: number | string, session_id: number | string, request_info?: TRequestInfo, is_2fa_validated?: boolean): Promise<TSessionModel | null>;
+    loadMemberLoginChallengeMethod?(member_id: number | string, challenge_id: number | string, request_info?: TRequestInfo, is_2fa_validated?: boolean): Promise<TLoginChallengeModel | null>;
+    loadMemberLoginChallenegeMethod?(member_id: number | string, challenge_id: number | string, request_info?: TRequestInfo, is_2fa_validated?: boolean): Promise<TLoginChallengeModel | null>;
+    getActorPermissionsMethod?(actor_id: number | string, role_ids: (number | string)[]): Promise<string[]>;
+    validateActorHasPermissionMethod?(request_info: TRequestInfo, req?: Request): Promise<boolean>;
+    requireNoAuthMiddleWareMethod?(req: Request, res: Response, next: NextFunction): Promise<void | Response>;
+    requirePartialAuthMiddleWareMethod?(req: Request, res: Response, next: NextFunction): Promise<void | Response>;
+    requireFullAuthMiddleWareMethod?(req: Request, res: Response, next: NextFunction): Promise<void | Response>;
+    requireAppAuthMiddleWareMethod?(req: Request, res: Response, next: NextFunction): Promise<void | Response>;
 }

package/dist/types/middle_ware_type.js

@@ -1,4 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-;
-;

package/dist/types/schema_type.js

@@ -1,3 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-;

package/dist/types/util_type.js

@@ -8,4 +8,3 @@ var ErrorHandlingStrategyEnum;
     ErrorHandlingStrategyEnum[ErrorHandlingStrategyEnum["THROW_ERROR"] = 2] = "THROW_ERROR";
     ErrorHandlingStrategyEnum[ErrorHandlingStrategyEnum["CONTROLLER_ERROR"] = 3] = "CONTROLLER_ERROR";
 })(ErrorHandlingStrategyEnum || (exports.ErrorHandlingStrategyEnum = ErrorHandlingStrategyEnum = {}));
-;

package/dist/utils/content_manager_util.js

@@ -16,30 +16,32 @@ class ContentManagerUtil {
     content_url_template;
     default_language;
     constructor() {
-        this.content_cache_ttl_ms = this.env_manager.getEnvVar(constants_1.CONTENT_CACHE_TTL_KEY, constants_1.DEFAULT_CONTENT_CACHE_TTL) ?? constants_1.DEFAULT_CONTENT_CACHE_TTL;
+        this.content_cache_ttl_ms =
+            this.env_manager.getEnvVar(constants_1.CONTENT_CACHE_TTL_KEY, constants_1.DEFAULT_CONTENT_CACHE_TTL) ??
+                constants_1.DEFAULT_CONTENT_CACHE_TTL;
         this.cache = new main_1.InMemoryCacheUtil();
         this.content_url_template = this.env_manager.getEnvVar(constants_1.CONTENT_URL_KEY, constants_1.DEFAULT_CONTENT_URL);
-        this.default_language = this.env_manager.getEnvVar(constants_1.CONTENT_LANG_KEY, constants_1.DEFAULT_CONTENT_LANG) ?? constants_1.DEFAULT_CONTENT_LANG;
+        this.default_language =
+            this.env_manager.getEnvVar(constants_1.CONTENT_LANG_KEY, constants_1.DEFAULT_CONTENT_LANG) ??
+                constants_1.DEFAULT_CONTENT_LANG;
         this.cleanUpCache();
     }
     // Method to clean cache up
     cleanUpCache() {
         //periodic cleanup (every 2 minutes)
-        setInterval(() => { this.cache.cleanup(); }, 120_000);
+        setInterval(() => {
+            this.cache.cleanup();
+        }, 120_000);
     }
     getCacheKey(type, lang) {
         return `content:${type}:${lang}`;
     }
     resolvePath(obj, path) {
-        return path
-            .split(".")
-            .reduce((acc, key) => (acc ? acc[key] : undefined), obj);
+        return path.split(".").reduce((acc, key) => (acc ? acc[key] : undefined), obj);
     }
     // Method to Load content from remote JSON endpoint
     async loadContent(type, lang) {
-        const url = this.content_url_template
-            ?.replace("{{type}}", type)
-            ?.replace("{{lang}}", lang);
+        const url = this.content_url_template?.replace("{{type}}", type)?.replace("{{lang}}", lang);
         if (!url) {
             throw new Error(`Invalid content URL for type=${type} lang=${lang}`);
         }

package/dist/utils/crypto_key_util.js

@@ -44,12 +44,12 @@ class CryptoKeyUtil {
             modulusLength: modulus_length,
             publicKeyEncoding: {
                 type: "spki",
-                format: "pem"
+                format: "pem",
             },
             privateKeyEncoding: {
                 type: "pkcs8",
-                format: "pem"
-            }
+                format: "pem",
+            },
         });
         return { public_key, private_key };
     }
@@ -61,12 +61,12 @@ class CryptoKeyUtil {
             namedCurve: named_curve,
             publicKeyEncoding: {
                 type: "spki",
-                format: "pem"
+                format: "pem",
             },
             privateKeyEncoding: {
                 type: "pkcs8",
-                format: "pem"
-            }
+                format: "pem",
+            },
         });
         return { public_key, private_key };
     }
@@ -92,7 +92,7 @@ class CryptoKeyUtil {
         const buffer = Buffer.from(payload, "utf8");
         const encrypted = (0, crypto_1.publicEncrypt)({
             key: public_key,
-            padding: crypto_1.default.constants.RSA_PKCS1_OAEP_PADDING
+            padding: crypto_1.default.constants.RSA_PKCS1_OAEP_PADDING,
         }, buffer);
         return encrypted.toString(output_encoding);
     }
@@ -100,7 +100,7 @@ class CryptoKeyUtil {
         const buffer = Buffer.from(encrypted_payload, input_encoding);
         const decrypted = (0, crypto_1.privateDecrypt)({
             key: private_key,
-            padding: crypto_1.default.constants.RSA_PKCS1_OAEP_PADDING
+            padding: crypto_1.default.constants.RSA_PKCS1_OAEP_PADDING,
         }, buffer);
         return decrypted.toString("utf8");
     }
@@ -120,8 +120,7 @@ class CryptoKeyUtil {
         HELPER: PEM VALIDATION
     ============================================================ */
     static isValidPEM(key) {
-        return (key.includes("-----BEGIN") &&
-            key.includes("-----END"));
+        return key.includes("-----BEGIN") && key.includes("-----END");
     }
 }
 exports.default = CryptoKeyUtil;

package/dist/utils/encryptor_decryptor_util.js

@@ -24,21 +24,28 @@ class EncryptorDecryptorUtil {
         this.encrypt_secret_key = this.setEncryptSecretKey(encrypt_secret_key);
         this.corpus_shift_key = this.env_manger.getEnvVar("CORPUS_SHIFT_KEY", 4) || 4;
         this.jwt_secret_key = this.env_manger.getEnvVar("JWT_SECRET_KEY", "");
-        if (!this.encrypt_secret_key ||
-            !this.jwt_secret_key) {
+        if (!this.encrypt_secret_key || !this.jwt_secret_key) {
             const msg = `Secret Key Variables are missing please set in envrionment variable`;
-            const data = { encrypt_secret_key: this.encrypt_secret_key, jwt_secret_key: this.jwt_secret_key };
+            const data = {
+                encrypt_secret_key: this.encrypt_secret_key,
+                jwt_secret_key: this.jwt_secret_key,
+            };
             this.logger.error(msg, { data });
             throw new Error(msg);
         }
     }
     verifyJWT(jwt_string, secret_key, ignore_expiration = false) {
         try {
-            const jwt_data = jsonwebtoken_1.default.verify(jwt_string, secret_key, { ignoreExpiration: ignore_expiration });
+            const jwt_data = jsonwebtoken_1.default.verify(jwt_string, secret_key, {
+                ignoreExpiration: ignore_expiration,
+            });
             return jwt_data;
         }
         catch (error) {
-            this.logger.error(`[${this.name}] JWT string has expired`, { jwt_string, ignore_expiration });
+            this.logger.error(`[${this.name}] JWT string has expired`, {
+                jwt_string,
+                ignore_expiration,
+            });
             return null;
         }
     }
@@ -135,8 +142,8 @@ class EncryptorDecryptorUtil {
             for (const char of array_input_data) {
                 const index = this.corpus.indexOf(char);
                 if (index !== -1) {
-                    const calc_shift = (index - this.corpus_shift_key);
-                    const new_index = calc_shift < 0 ? (this.corpus.length + calc_shift) : calc_shift;
+                    const calc_shift = index - this.corpus_shift_key;
+                    const new_index = calc_shift < 0 ? this.corpus.length + calc_shift : calc_shift;
                     decrypted_data += this.corpus[new_index];
                 }
                 else {
@@ -207,11 +214,14 @@ class EncryptorDecryptorUtil {
             if (!decompressed_data) {
                 return null;
             }
-            const decoded_data = (this.decryptV2(decompressed_data));
+            const decoded_data = this.decryptV2(decompressed_data);
             return decoded_data || null;
         }
         catch (error) {
-            this.logger.error(`[${this.name}] Failed to convert encrypted string to data`, { encrypted_string, error });
+            this.logger.error(`[${this.name}] Failed to convert encrypted string to data`, {
+                encrypted_string,
+                error,
+            });
             return null;
         }
     }

package/dist/utils/env_manager_util.d.ts

@@ -7,6 +7,7 @@ declare class EnvManagerUtil {
     private readonly logger;
     env_data: EnvConfigInterface;
     private constructor();
+    private resolveEnvFilePath;
     private getEnvFileName;
     static getInstance(env_var_options?: EnvVarConfigOptions): EnvManagerUtil;
     private readENVData;

package/dist/utils/env_manager_util.js

@@ -19,10 +19,18 @@ class EnvManagerUtil {
     // 🔒 Private constructor
     constructor(env_var_options) {
         this.env_file_name = this.getEnvFileName(env_var_options);
-        this.yaml_env_file_path = path_1.default.join(constants_1.ENV_VAR_DIR, this.env_file_name);
+        this.yaml_env_file_path = this.resolveEnvFilePath(this.env_file_name);
         this.logger = new logger_util_1.default(this.name);
         this.env_data = this.readENVData();
     }
+    resolveEnvFilePath(env_file_name) {
+        const preferred_path = path_1.default.join(constants_1.ENV_VAR_DIR, env_file_name);
+        const legacy_path = path_1.default.join(constants_1.LEGACY_ENV_VAR_DIR, env_file_name);
+        if (!fs_1.default.existsSync(preferred_path) && fs_1.default.existsSync(legacy_path)) {
+            return legacy_path;
+        }
+        return preferred_path;
+    }
     // Method to get env file name
     getEnvFileName(env_var_options) {
         if (process?.env?.MODE === "development") {
@@ -60,7 +68,7 @@ class EnvManagerUtil {
             return {};
         }
     }
-    // Get env var from YAML → process.env → default 
+    // Get env var from YAML → process.env → default
     getEnvVar(key, default_value) {
         if (key in this.env_data) {
             return this.env_data[key];

package/dist/utils/fs_actions_util.js

@@ -60,7 +60,7 @@ class FSActionUtil {
         if (!exists)
             return;
         const entries = await fs_1.promises.readdir(dir_path);
-        await Promise.all(entries.map(entry => fs_1.promises.rm(path_1.default.join(dir_path, entry), {
+        await Promise.all(entries.map((entry) => fs_1.promises.rm(path_1.default.join(dir_path, entry), {
             recursive: true,
             force: true,
         })));

package/dist/utils/input_transformer_util.js

@@ -22,9 +22,7 @@ class InputTransformerUtil {
      * Capitalize the first letter of a string
      */
     static capitalize(input) {
-        return input
-            ? input.charAt(0).toUpperCase() + input.slice(1).toLowerCase()
-            : input;
+        return input ? input.charAt(0).toUpperCase() + input.slice(1).toLowerCase() : input;
     }
     /**
      * Capitalize the first letter of each word in a string
@@ -65,9 +63,7 @@ class InputTransformerUtil {
         if (!amount) {
             return "0";
         }
-        return amount > 0
-            ? Intl.NumberFormat("en-US").format(amount)
-            : amount.toString();
+        return amount > 0 ? Intl.NumberFormat("en-US").format(amount) : amount.toString();
     }
     /**
      * Format large numbers with suffixes (K, M, B, T)
@@ -105,9 +101,7 @@ class InputTransformerUtil {
      */
     static async ipAddressToLocation(ip_address = null) {
         try {
-            const suffix = !ip_address || ip_address === "::1"
-                ? "s"
-                : `?ip=${ip_address}`;
+            const suffix = !ip_address || ip_address === "::1" ? "s" : `?ip=${ip_address}`;
             const response = await axios_1.default.get(`https://ip2c.org/${suffix}`);
             const response_text = response.data.toString();
             if (response_text[0] === "1") {
@@ -130,8 +124,7 @@ class InputTransformerUtil {
         let age = today.getFullYear() - dob_date.getFullYear();
         const month_difference = today.getMonth() - dob_date.getMonth();
         if (month_difference < 0 ||
-            (month_difference === 0 &&
-                today.getDate() < dob_date.getDate())) {
+            (month_difference === 0 && today.getDate() < dob_date.getDate())) {
             age--;
         }
         return age;
@@ -188,8 +181,7 @@ class InputTransformerUtil {
         const parts = snake_str.split("_");
         const last_word = parts.pop();
         let plural_word;
-        if (last_word.endsWith("y") &&
-            !/[aeiou]y$/.test(last_word)) {
+        if (last_word.endsWith("y") && !/[aeiou]y$/.test(last_word)) {
             plural_word = last_word.slice(0, -1) + "ies";
         }
         else if (["s", "x", "z"].includes(last_word.slice(-1)) ||
@@ -281,12 +273,10 @@ class InputTransformerUtil {
             if (old_value == new_value) {
                 continue;
             }
-            const formatted_old = typeof old_value === "object" &&
-                old_value !== null
+            const formatted_old = typeof old_value === "object" && old_value !== null
                 ? JSON.stringify(old_value)
                 : String(old_value ?? "null");
-            const formatted_new = typeof new_value === "object" &&
-                new_value !== null
+            const formatted_new = typeof new_value === "object" && new_value !== null
                 ? JSON.stringify(new_value)
                 : String(new_value ?? "null");
             structured_diff[key] = {
@@ -298,8 +288,7 @@ class InputTransformerUtil {
             .map(([key, value]) => `${key} changed from '${value.old}' → '${value.new}'`)
             .join("; ");
         return {
-            readable: readable_changes ||
-                "No significant changes detected",
+            readable: readable_changes || "No significant changes detected",
             structured: structured_diff,
         };
     }
@@ -309,9 +298,7 @@ class InputTransformerUtil {
     static formatLinksObject(links) {
         const formatted_links = {};
         for (const [key, value] of Object.entries(links)) {
-            const normalized_key = key
-                .toLowerCase()
-                .endsWith("_link")
+            const normalized_key = key.toLowerCase().endsWith("_link")
                 ? key.toLowerCase()
                 : `${key.toLowerCase()}_link`;
             formatted_links[normalized_key] = value;
@@ -327,8 +314,7 @@ class InputTransformerUtil {
             for (let i = 0; i < parts.length; i++) {
                 const key = parts[i];
                 if (!current[key]) {
-                    current[key] =
-                        i === parts.length - 1 ? "string" : {};
+                    current[key] = i === parts.length - 1 ? "string" : {};
                 }
                 current = current[key];
             }
@@ -362,7 +348,7 @@ class InputTransformerUtil {
         // Ensure parts is always a flat array of strings
         const flat_parts = Array.isArray(parts) ? parts : [parts];
         // Filter out empty/null/undefined strings to avoid extra separators
-        const valid_parts = flat_parts.filter(part => part !== null && part !== undefined && part !== "");
+        const valid_parts = flat_parts.filter((part) => part !== null && part !== undefined && part !== "");
         return valid_parts.join(separator);
     }
 }

package/dist/utils/input_validator_util.d.ts

@@ -10,7 +10,7 @@ declare class InputValidatorUtil {
     private static readonly text_area_regex_reg_exp;
     private static readonly uuid_regex_reg_exp;
     private static readonly custom_uuid_regex_reg_exp;
-    private static readonly env_manager;
+    private static get env_manager();
     static isValidateIn: (value: any, allowed: any[]) => boolean;
     /** ✅ Check member roles */
     static isAdmin(name: string): boolean;

package/dist/utils/input_validator_util.js

@@ -22,23 +22,53 @@ class InputValidatorUtil {
     static text_area_regex_reg_exp = /^(?=.*[a-zA-Z])[\p{L}\p{N}\p{P}\p{Zs}–—“”‘’]*$/u;
     static uuid_regex_reg_exp = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
     static custom_uuid_regex_reg_exp = /^[A-Z0-9]{12}-[A-Z0-9]{12}-[A-Z0-9]{12}-[A-Z0-9]{12}$/;
-    static env_manager = env_manager_util_1.default.getInstance();
+    static get env_manager() {
+        return env_manager_util_1.default.getInstance();
+    }
     static isValidateIn = (value, allowed) => allowed.includes(value);
     /** ✅ Check member roles */
-    static isAdmin(name) { return ["SuperAdmin", "AdminI", "AdminT"].includes(name); }
-    static isSuperAdmin(name) { return name === "SuperAdmin"; }
-    static isLowerSnakeCase(str) { return /^[a-z]+(_[a-z]+)*$/.test(str); }
-    static isUpperPascalCase(str) { return /^[A-Z][a-zA-Z]*$/.test(str); }
-    static isEmpty(input) { return !input || input.toString().trim() === ""; }
-    static isValidOptionalField(str) { return this.optional_field_regex.test(str); }
-    static isValidName(name) { return this.name_regex_reg_exp.test(name); }
-    static isValidNamey(name) { return this.namey_regex_reg_exp.test(name); }
-    static isValidEmail(email) { return this.email_regex_reg_exp.test(email) && email.length <= 254; }
-    static isValidPhoneNumber(tel) { return this.tel_regex_reg_exp.test(tel); }
-    static isValidPassword(password) { return this.pass_regex_reg_exp.test(password); }
-    static isDigit(input) { return typeof input === "number" || !isNaN(Number(input)); }
-    static isValidInteger(input) { return Number.isInteger(input) && input > 0; }
-    static isValidFloat(input) { return !isNaN(Number(input)) && parseFloat(input) > 0; }
+    static isAdmin(name) {
+        return ["SuperAdmin", "AdminI", "AdminT"].includes(name);
+    }
+    static isSuperAdmin(name) {
+        return name === "SuperAdmin";
+    }
+    static isLowerSnakeCase(str) {
+        return /^[a-z]+(_[a-z]+)*$/.test(str);
+    }
+    static isUpperPascalCase(str) {
+        return /^[A-Z][a-zA-Z]*$/.test(str);
+    }
+    static isEmpty(input) {
+        return !input || input.toString().trim() === "";
+    }
+    static isValidOptionalField(str) {
+        return this.optional_field_regex.test(str);
+    }
+    static isValidName(name) {
+        return this.name_regex_reg_exp.test(name);
+    }
+    static isValidNamey(name) {
+        return this.namey_regex_reg_exp.test(name);
+    }
+    static isValidEmail(email) {
+        return this.email_regex_reg_exp.test(email) && email.length <= 254;
+    }
+    static isValidPhoneNumber(tel) {
+        return this.tel_regex_reg_exp.test(tel);
+    }
+    static isValidPassword(password) {
+        return this.pass_regex_reg_exp.test(password);
+    }
+    static isDigit(input) {
+        return typeof input === "number" || !isNaN(Number(input));
+    }
+    static isValidInteger(input) {
+        return Number.isInteger(input) && input > 0;
+    }
+    static isValidFloat(input) {
+        return !isNaN(Number(input)) && parseFloat(input) > 0;
+    }
     static isValidURLY(url) {
         try {
             new URL(url);
@@ -48,8 +78,12 @@ class InputValidatorUtil {
             return false;
         }
     }
-    static isValidURL(url) { return this.url_regex_reg_exp.test(url) && this.isValidURLY(url); }
-    static isBoolean(value) { return typeof value === "boolean" || ["1", "0"].includes(String(value)); }
+    static isValidURL(url) {
+        return this.url_regex_reg_exp.test(url) && this.isValidURLY(url);
+    }
+    static isBoolean(value) {
+        return typeof value === "boolean" || ["1", "0"].includes(String(value));
+    }
     static isValidLongText(text) {
         if (!text || typeof text !== "string") {
             return false;
@@ -60,9 +94,15 @@ class InputValidatorUtil {
         }
         return this.text_area_regex_reg_exp.test(text.trim());
     }
-    static isValidUUID(uuid) { return this.uuid_regex_reg_exp.test(uuid); }
-    static isValidCustomUUID(uuid) { return this.custom_uuid_regex_reg_exp.test(uuid); }
-    static isArrayUnique(arr) { return new Set(arr).size === arr.length; }
+    static isValidUUID(uuid) {
+        return this.uuid_regex_reg_exp.test(uuid);
+    }
+    static isValidCustomUUID(uuid) {
+        return this.custom_uuid_regex_reg_exp.test(uuid);
+    }
+    static isArrayUnique(arr) {
+        return new Set(arr).size === arr.length;
+    }
     static isValidFutureDate(date_string) {
         const date = (0, dayjs_1.default)(date_string);
         return date.isValid() && date.isAfter((0, dayjs_1.default)());
@@ -87,10 +127,18 @@ class InputValidatorUtil {
         return await bcrypt_1.default.compare(password, hash_password);
     }
     /** ✅ Check environment */
-    static isProduction() { return InputValidatorUtil?.env_manager?.env_data?.MODE === "production"; }
-    static isStaging() { return InputValidatorUtil?.env_manager?.env_data?.MODE === "staging"; }
-    static isDevelopment() { return InputValidatorUtil?.env_manager?.env_data?.MODE === "development"; }
-    static isLive() { return ["production", "staging"].includes(InputValidatorUtil?.env_manager?.env_data?.MODE || ""); }
+    static isProduction() {
+        return InputValidatorUtil?.env_manager?.env_data?.MODE === "production";
+    }
+    static isStaging() {
+        return InputValidatorUtil?.env_manager?.env_data?.MODE === "staging";
+    }
+    static isDevelopment() {
+        return InputValidatorUtil?.env_manager?.env_data?.MODE === "development";
+    }
+    static isLive() {
+        return ["production", "staging"].includes(InputValidatorUtil?.env_manager?.env_data?.MODE || "");
+    }
     /** ✅ Validate ReCaptcha */
     static async isValidReCaptcha(recpatcha_token) {
         const { RECAPTCHA_SECRET_KEY, RECPATHA_VERIFY_URL } = InputValidatorUtil?.env_manager?.env_data;
@@ -113,7 +161,7 @@ class InputValidatorUtil {
             return exist;
         }
         if (!exist) {
-            fs_1.default.mkdirSync(directory);
+            fs_1.default.mkdirSync(directory, { recursive: true });
         }
         return return_dir_path ? directory : true;
     }
@@ -189,8 +237,8 @@ class InputValidatorUtil {
         };
         // Utility to get nested value by dot notation
         const getNestedValue = (obj, path) => {
-            return path.split('.').reduce((acc, part) => {
-                if (acc && typeof acc === 'object' && part in acc) {
+            return path.split(".").reduce((acc, part) => {
+                if (acc && typeof acc === "object" && part in acc) {
                     return acc[part];
                 }
                 return undefined;

package/dist/utils/logger_util.d.ts

@@ -10,12 +10,12 @@ declare class LoggerUtil {
      * Ensures a directory exists. If it doesn't, creates it.
      * @param directory_path - Path to the directory
      * @returns The absolute path of the ensured directory
-    */
+     */
     private ensureDirExists;
     /**
      * Generate log unique log file name with timestamp and module name
      * @returns The absolute path of the module log file
-    */
+     */
     private getLogFilePath;
     private safeStringify;
     private log;