fiberx-backend-toolkit 0.0.73 → 0.0.74

package/dist/middle_ware/request_logger_middle_ware.js

@@ -21,7 +21,7 @@ class RequestLoggerMiddleWare {
     // -------------------------
     async middleWare(req, res, next) {
         const origin = req.headers.origin || (req.headers.referer ? new URL(req.headers.referer).origin : "unknown");
-        const device_id = req.headers["x-device-id"] || "unknown";
+        const device_id = req.cookies?.device_id || req.headers["x-device-id"] || "unknown";
         const device_name = req.headers["x-device-name"] || "unknown";
         const user_agent = req.headers["user-agent"] || "unknown";
         const request_id = req.cookies?.request_id ?? null;

package/dist/utils/fs_actions_util.d.ts

@@ -0,0 +1,14 @@
+declare class FSActionUtil {
+    private static validateSafePath;
+    static exists(target_path: string): Promise<boolean>;
+    static createDirectory(dir_path: string, recursive?: boolean): Promise<void>;
+    static renameDirectory(old_path: string, new_path: string): Promise<void>;
+    static deleteDirectory(dir_path: string): Promise<void>;
+    static clearDirectory(dir_path: string): Promise<void>;
+    static readDirectory(dir_path: string, withStats?: boolean): Promise<string[] | {
+        name: string;
+        isFile: boolean;
+        isDirectory: boolean;
+    }[]>;
+}
+export default FSActionUtil;

package/dist/utils/fs_actions_util.js

@@ -0,0 +1,89 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+class FSActionUtil {
+    // ==============================
+    // Private Safety Guard
+    // ==============================
+    static validateSafePath(target_path) {
+        if (!target_path || target_path === "/" || target_path.length < 3) {
+            throw new Error(`Unsafe path operation attempted: ${target_path}`);
+        }
+    }
+    // ==============================
+    // Check if path exists
+    // ==============================
+    static async exists(target_path) {
+        try {
+            await fs_1.promises.access(target_path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // ==============================
+    // Create Directory
+    // ==============================
+    static async createDirectory(dir_path, recursive = true) {
+        this.validateSafePath(dir_path);
+        await fs_1.promises.mkdir(dir_path, { recursive });
+    }
+    // ==============================
+    // Rename Directory
+    // ==============================
+    static async renameDirectory(old_path, new_path) {
+        this.validateSafePath(old_path);
+        this.validateSafePath(new_path);
+        await fs_1.promises.rename(old_path, new_path);
+    }
+    // ==============================
+    // Delete Directory (entire)
+    // ==============================
+    static async deleteDirectory(dir_path) {
+        this.validateSafePath(dir_path);
+        await fs_1.promises.rm(dir_path, {
+            recursive: true,
+            force: true,
+        });
+    }
+    // ==============================
+    // Clear Directory (keep folder)
+    // ==============================
+    static async clearDirectory(dir_path) {
+        this.validateSafePath(dir_path);
+        const exists = await this.exists(dir_path);
+        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), {
+            recursive: true,
+            force: true,
+        })));
+    }
+    // ==============================
+    // Read Directory Contents
+    // ==============================
+    static async readDirectory(dir_path, withStats = false) {
+        this.validateSafePath(dir_path);
+        const entries = await fs_1.promises.readdir(dir_path);
+        if (!withStats) {
+            return entries;
+        }
+        const detailed = await Promise.all(entries.map(async (entry) => {
+            const fullPath = path_1.default.join(dir_path, entry);
+            const stats = await fs_1.promises.stat(fullPath);
+            return {
+                name: entry,
+                isFile: stats.isFile(),
+                isDirectory: stats.isDirectory(),
+            };
+        }));
+        return detailed;
+    }
+}
+exports.default = FSActionUtil;

package/dist/utils/main.d.ts

@@ -10,4 +10,5 @@ import UUIDGeneratorUtil from "./uuid_gen_util";
 import EncryptorDecryptorUtil from "./encryptor_decryptor_util";
 import TOTPServiceUtil from "./totp_service_util";
 import ContentManagerUtil from "./content_manager_util";
-export { LoggerUtil, InputTransformerUtil, InputValidatorUtil, EnvManagerUtil, SqlFormatterUtil, ServerUtil, SafeExecuteUtil, InMemoryCacheUtil, UUIDGeneratorUtil, EncryptorDecryptorUtil, TOTPServiceUtil, ContentManagerUtil };
+import FsActionsUtil from "./fs_actions_util";
+export { LoggerUtil, InputTransformerUtil, InputValidatorUtil, EnvManagerUtil, SqlFormatterUtil, ServerUtil, SafeExecuteUtil, InMemoryCacheUtil, UUIDGeneratorUtil, EncryptorDecryptorUtil, TOTPServiceUtil, ContentManagerUtil, FsActionsUtil };

package/dist/utils/main.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ContentManagerUtil = exports.TOTPServiceUtil = exports.EncryptorDecryptorUtil = exports.UUIDGeneratorUtil = exports.InMemoryCacheUtil = exports.SafeExecuteUtil = exports.ServerUtil = exports.SqlFormatterUtil = exports.EnvManagerUtil = exports.InputValidatorUtil = exports.InputTransformerUtil = exports.LoggerUtil = void 0;
+exports.FsActionsUtil = exports.ContentManagerUtil = exports.TOTPServiceUtil = exports.EncryptorDecryptorUtil = exports.UUIDGeneratorUtil = exports.InMemoryCacheUtil = exports.SafeExecuteUtil = exports.ServerUtil = exports.SqlFormatterUtil = exports.EnvManagerUtil = exports.InputValidatorUtil = exports.InputTransformerUtil = exports.LoggerUtil = void 0;
 const logger_util_1 = __importDefault(require("./logger_util"));
 exports.LoggerUtil = logger_util_1.default;
 const input_transformer_util_1 = __importDefault(require("./input_transformer_util"));
@@ -28,3 +28,5 @@ const totp_service_util_1 = __importDefault(require("./totp_service_util"));
 exports.TOTPServiceUtil = totp_service_util_1.default;
 const content_manager_util_1 = __importDefault(require("./content_manager_util"));
 exports.ContentManagerUtil = content_manager_util_1.default;
+const fs_actions_util_1 = __importDefault(require("./fs_actions_util"));
+exports.FsActionsUtil = fs_actions_util_1.default;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "fiberx-backend-toolkit",
-    "version": "0.0.73",
+    "version": "0.0.74",
     "description": "A TypeScript backend toolkit providing shared domain logic, infrastructure helpers, and utilities for FiberX server-side applications and services.",
     "type": "commonjs",
     "main": "./dist/index.js",