cadenlane-cli-2 1.0.0

package/dist/domain/services/path-resolver.service.js

@@ -0,0 +1,332 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathResolverService = void 0;
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+/**
+ * PathResolver Service
+ * Handles cross-platform path resolution and validation
+ *
+ * Design Principles:
+ * - All paths must be absolute
+ * - Platform-specific validation (Windows drive letters, Unix root)
+ * - Home directory expansion support (~)
+ * - Environment variable expansion (%VAR% on Windows, $VAR on Unix)
+ */
+class PathResolverService {
+    platformInfo;
+    constructor() {
+        const platform = process.platform;
+        this.platformInfo = {
+            platform,
+            isWindows: platform === 'win32',
+            isMac: platform === 'darwin',
+            isLinux: platform === 'linux',
+            homeDir: os.homedir(),
+            separator: path.sep,
+        };
+    }
+    /**
+     * Get current platform information
+     */
+    getPlatformInfo() {
+        return { ...this.platformInfo };
+    }
+    /**
+     * Resolve a path to an absolute path with platform-specific handling
+     * @param inputPath - The path to resolve (can include ~ or env vars)
+     * @param fallbackPath - Optional fallback if resolution fails
+     * @returns Resolution result with absolute path or error
+     */
+    resolve(inputPath, fallbackPath) {
+        try {
+            // If primary path is invalid, try fallback first
+            if (!inputPath || typeof inputPath !== 'string' || inputPath.trim() === '') {
+                if (fallbackPath) {
+                    return this.resolve(fallbackPath);
+                }
+                return {
+                    absolutePath: '',
+                    isValid: false,
+                    error: 'Path is empty or invalid',
+                    platform: this.platformInfo.platform,
+                };
+            }
+            let resolvedPath = inputPath.trim();
+            // Step 1: Expand home directory (~)
+            resolvedPath = this.expandHomeDirectory(resolvedPath);
+            // Step 2: Expand environment variables
+            resolvedPath = this.expandEnvironmentVariables(resolvedPath);
+            // Step 3: Normalize path separators
+            resolvedPath = this.normalizeSeparators(resolvedPath);
+            // Step 4: Check if path is absolute (platform-aware)
+            const isAbsolute = this.isPathAbsolute(resolvedPath);
+            if (!isAbsolute) {
+                return {
+                    absolutePath: resolvedPath,
+                    isValid: false,
+                    error: `Path must be absolute. Got: ${resolvedPath}`,
+                    platform: this.platformInfo.platform,
+                };
+            }
+            // Step 5: Normalize the path
+            resolvedPath = path.normalize(resolvedPath);
+            // Step 6: Platform-specific validation
+            const validationError = this.validatePlatformPath(resolvedPath);
+            if (validationError) {
+                // If validation fails and we have a fallback, try it
+                if (fallbackPath && fallbackPath !== inputPath) {
+                    return this.resolve(fallbackPath);
+                }
+                return {
+                    absolutePath: resolvedPath,
+                    isValid: false,
+                    error: validationError,
+                    platform: this.platformInfo.platform,
+                };
+            }
+            return {
+                absolutePath: resolvedPath,
+                isValid: true,
+                platform: this.platformInfo.platform,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                absolutePath: '',
+                isValid: false,
+                error: `Path resolution failed: ${message}`,
+                platform: this.platformInfo.platform,
+            };
+        }
+    }
+    /**
+     * Get default download path for current platform
+     * @returns Platform-specific default download directory
+     */
+    getDefaultDownloadPath() {
+        if (this.platformInfo.isWindows) {
+            // Windows: C:\Users\{username}\Downloads
+            return path.join(this.platformInfo.homeDir, 'Downloads');
+        }
+        else {
+            // Mac/Linux: ~/Downloads
+            return path.join(this.platformInfo.homeDir, 'Downloads');
+        }
+    }
+    /**
+     * Expand home directory shorthand (~)
+     * Works on all platforms
+     */
+    expandHomeDirectory(inputPath) {
+        if (inputPath.startsWith('~/') || inputPath.startsWith('~\\')) {
+            // Join home dir with the rest of the path
+            const restOfPath = inputPath.slice(2);
+            return path.join(this.platformInfo.homeDir, restOfPath);
+        }
+        if (inputPath === '~') {
+            return this.platformInfo.homeDir;
+        }
+        return inputPath;
+    }
+    /**
+     * Expand environment variables
+     * - Windows: %VAR%
+     * - Unix: $VAR or ${VAR}
+     */
+    expandEnvironmentVariables(inputPath) {
+        if (this.platformInfo.isWindows) {
+            // Windows: %USERPROFILE%, %APPDATA%, etc.
+            return inputPath.replace(/%([^%]+)%/g, (_, varName) => {
+                return process.env[varName] || `%${varName}%`;
+            });
+        }
+        else {
+            // Unix: $HOME, ${HOME}, etc.
+            return inputPath
+                .replace(/\$\{([^}]+)\}/g, (_, varName) => {
+                return process.env[varName] || `\${${varName}}`;
+            })
+                .replace(/\$([A-Z_][A-Z0-9_]*)/g, (_, varName) => {
+                return process.env[varName] || `$${varName}`;
+            });
+        }
+    }
+    /**
+     * Normalize path separators for current platform
+     */
+    normalizeSeparators(inputPath) {
+        if (this.platformInfo.isWindows) {
+            // Convert forward slashes to backslashes on Windows
+            return inputPath.replace(/\//g, '\\');
+        }
+        else {
+            // Convert backslashes to forward slashes on Unix
+            return inputPath.replace(/\\/g, '/');
+        }
+    }
+    /**
+     * Check if path is absolute (platform-aware)
+     * This is more reliable than path.isAbsolute() for cross-platform testing
+     */
+    isPathAbsolute(inputPath) {
+        if (this.platformInfo.isWindows) {
+            // Windows: Check for drive letter (C:\) or UNC path (\\server\share)
+            const driveLetterRegex = /^[a-zA-Z]:\\/;
+            const uncRegex = /^\\\\[^\\]+\\[^\\]+/;
+            return driveLetterRegex.test(inputPath) || uncRegex.test(inputPath);
+        }
+        else {
+            // Unix: Must start with /
+            return inputPath.startsWith('/');
+        }
+    }
+    /**
+     * Validate path for current platform
+     * @returns Error message if invalid, undefined if valid
+     */
+    validatePlatformPath(absolutePath) {
+        if (this.platformInfo.isWindows) {
+            return this.validateWindowsPath(absolutePath);
+        }
+        else {
+            return this.validateUnixPath(absolutePath);
+        }
+    }
+    /**
+     * Validate Windows-specific path requirements
+     */
+    validateWindowsPath(absolutePath) {
+        // Check for drive letter (C:, D:, etc.)
+        const driveLetterRegex = /^[a-zA-Z]:\\/;
+        if (!driveLetterRegex.test(absolutePath)) {
+            // Check for UNC path (\\server\share)
+            const uncRegex = /^\\\\[^\\]+\\[^\\]+/;
+            if (!uncRegex.test(absolutePath)) {
+                return `Windows path must start with drive letter (e.g., C:\\) or UNC path (e.g., \\\\server\\share). Got: ${absolutePath}`;
+            }
+        }
+        // Check for invalid Windows characters: < > : " | ? *
+        // Note: : is allowed in drive letter position
+        const invalidChars = /[<>"|?*]/;
+        const pathWithoutDrive = absolutePath.substring(3); // Skip C:\
+        if (invalidChars.test(pathWithoutDrive)) {
+            return `Windows path contains invalid characters (< > " | ? *): ${absolutePath}`;
+        }
+        // Check for reserved names (CON, PRN, AUX, NUL, COM1-9, LPT1-9)
+        const reservedNames = /^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])$/i;
+        const pathParts = absolutePath.split('\\');
+        for (const part of pathParts) {
+            const nameWithoutExt = part.split('.')[0];
+            if (reservedNames.test(nameWithoutExt)) {
+                return `Windows path contains reserved name: ${part}`;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Validate Unix-specific path requirements (Mac/Linux)
+     */
+    validateUnixPath(absolutePath) {
+        // Must start with /
+        if (!absolutePath.startsWith('/')) {
+            return `Unix path must start with /. Got: ${absolutePath}`;
+        }
+        // Check for null bytes (security)
+        if (absolutePath.includes('\0')) {
+            return 'Path contains null bytes';
+        }
+        return undefined;
+    }
+    /**
+     * Format a path example for current platform
+     * Useful for error messages and UI placeholders
+     */
+    getPathExample(type) {
+        if (this.platformInfo.isWindows) {
+            switch (type) {
+                case 'downloads':
+                    return 'C:\\Users\\YourName\\Downloads';
+                case 'documents':
+                    return 'C:\\Users\\YourName\\Documents';
+                case 'desktop':
+                    return 'C:\\Users\\YourName\\Desktop';
+                case 'custom':
+                    return 'C:\\MyFolder\\Images';
+            }
+        }
+        else if (this.platformInfo.isMac) {
+            switch (type) {
+                case 'downloads':
+                    return '/Users/YourName/Downloads';
+                case 'documents':
+                    return '/Users/YourName/Documents';
+                case 'desktop':
+                    return '/Users/YourName/Desktop';
+                case 'custom':
+                    return '/Users/YourName/MyFolder/Images';
+            }
+        }
+        else {
+            // Linux
+            switch (type) {
+                case 'downloads':
+                    return '/home/username/Downloads';
+                case 'documents':
+                    return '/home/username/Documents';
+                case 'desktop':
+                    return '/home/username/Desktop';
+                case 'custom':
+                    return '/home/username/myfolder/images';
+            }
+        }
+    }
+    /**
+     * Check if a path is safe (no directory traversal)
+     * This is a secondary check after resolution
+     */
+    isSafePath(absolutePath) {
+        // Normalize the path first
+        const normalized = path.normalize(absolutePath);
+        // Check for .. in the path segments
+        // path.normalize should resolve these, but we check anyway
+        const segments = normalized.split(/[/\\]/);
+        return !segments.includes('..');
+    }
+}
+exports.PathResolverService = PathResolverService;
+//# sourceMappingURL=path-resolver.service.js.map

package/dist/domain/services/path-resolver.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.service.js","sourceRoot":"","sources":["../../../src/domain/services/path-resolver.service.ts"],"names":[],"mappings":"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"}

package/dist/domain/validators/index.d.ts

@@ -0,0 +1,4 @@
+export { MessageValidator, ValidationResult } from './message.validator';
+export { UrlValidator } from './url.validator';
+export { PathValidator } from './path.validator';
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/validators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/validators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/domain/validators/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathValidator = exports.UrlValidator = exports.MessageValidator = void 0;
+var message_validator_1 = require("./message.validator");
+Object.defineProperty(exports, "MessageValidator", { enumerable: true, get: function () { return message_validator_1.MessageValidator; } });
+var url_validator_1 = require("./url.validator");
+Object.defineProperty(exports, "UrlValidator", { enumerable: true, get: function () { return url_validator_1.UrlValidator; } });
+var path_validator_1 = require("./path.validator");
+Object.defineProperty(exports, "PathValidator", { enumerable: true, get: function () { return path_validator_1.PathValidator; } });
+//# sourceMappingURL=index.js.map

package/dist/domain/validators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/validators/index.ts"],"names":[],"mappings":";;;AAAA,yDAAyE;AAAhE,qHAAA,gBAAgB,OAAA;AACzB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA"}

package/dist/domain/validators/message.validator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Validation result interface
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    errors: string[];
+}
+/**
+ * Message Validator
+ * Validates queue message structure and required fields
+ */
+export declare class MessageValidator {
+    /**
+     * Validates a queue message
+     * @param message - The message to validate
+     * @returns ValidationResult with isValid flag and error messages
+     */
+    validate(message: any): ValidationResult;
+}
+//# sourceMappingURL=message.validator.d.ts.map

package/dist/domain/validators/message.validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.validator.d.ts","sourceRoot":"","sources":["../../../src/domain/validators/message.validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,GAAG,GAAG,gBAAgB;CAkBzC"}

package/dist/domain/validators/message.validator.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageValidator = void 0;
+/**
+ * Message Validator
+ * Validates queue message structure and required fields
+ */
+class MessageValidator {
+    /**
+     * Validates a queue message
+     * @param message - The message to validate
+     * @returns ValidationResult with isValid flag and error messages
+     */
+    validate(message) {
+        const errors = [];
+        // Check if file_url exists and is a non-empty string
+        if (!message.file_url || typeof message.file_url !== 'string' || message.file_url.trim() === '') {
+            errors.push('file_url is required');
+        }
+        // Check if target_folder exists and is a non-empty string
+        if (!message.target_folder || typeof message.target_folder !== 'string' || message.target_folder.trim() === '') {
+            errors.push('target_folder is required');
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+        };
+    }
+}
+exports.MessageValidator = MessageValidator;
+//# sourceMappingURL=message.validator.js.map

package/dist/domain/validators/message.validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.validator.js","sourceRoot":"","sources":["../../../src/domain/validators/message.validator.ts"],"names":[],"mappings":";;;AAQA;;;GAGG;AACH,MAAa,gBAAgB;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,OAAY;QACnB,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,qDAAqD;QACrD,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAChG,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACtC,CAAC;QAED,0DAA0D;QAC1D,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,OAAO,OAAO,CAAC,aAAa,KAAK,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC/G,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC5B,MAAM;SACP,CAAC;IACJ,CAAC;CACF;AAxBD,4CAwBC"}

package/dist/domain/validators/path.validator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Path Validator
+ * Validates file system paths and prevents directory traversal attacks
+ *
+ * NOTE: This validator provides basic validation.
+ * For comprehensive cross-platform path resolution and validation,
+ * use PathResolverService from @/domain/services/path-resolver.service
+ */
+export declare class PathValidator {
+    private readonly isWindows;
+    constructor();
+    /**
+     * Validates if a string is a valid path
+     * @param filePath - The path to validate
+     * @returns true if valid, false otherwise
+     */
+    isValid(filePath: any): boolean;
+    /**
+     * Validates Windows-specific path format
+     */
+    private isValidWindowsPath;
+    /**
+     * Validates Unix-specific path format (Mac/Linux)
+     */
+    private isValidUnixPath;
+    /**
+     * Checks if a path is safe (no directory traversal)
+     * @param filePath - The path to check
+     * @returns true if safe, false otherwise
+     */
+    isSafe(filePath: string): boolean;
+    /**
+     * Normalizes a file path using platform-specific separators
+     * @param filePath - The path to normalize
+     * @returns Normalized path
+     */
+    normalize(filePath: string): string;
+    /**
+     * Check if path is absolute
+     * Cross-platform compatible
+     */
+    isAbsolute(filePath: string): boolean;
+}
+//# sourceMappingURL=path.validator.d.ts.map

package/dist/domain/validators/path.validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.validator.d.ts","sourceRoot":"","sources":["../../../src/domain/validators/path.validator.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;;IAMpC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO;IAoB/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IA6BjC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAgBnC;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAGtC"}

package/dist/domain/validators/path.validator.js

@@ -0,0 +1,156 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathValidator = void 0;
+const path = __importStar(require("path"));
+/**
+ * Path Validator
+ * Validates file system paths and prevents directory traversal attacks
+ *
+ * NOTE: This validator provides basic validation.
+ * For comprehensive cross-platform path resolution and validation,
+ * use PathResolverService from @/domain/services/path-resolver.service
+ */
+class PathValidator {
+    isWindows;
+    constructor() {
+        this.isWindows = process.platform === 'win32';
+    }
+    /**
+     * Validates if a string is a valid path
+     * @param filePath - The path to validate
+     * @returns true if valid, false otherwise
+     */
+    isValid(filePath) {
+        if (!filePath || typeof filePath !== 'string' || filePath.trim() === '') {
+            return false;
+        }
+        const trimmed = filePath.trim();
+        // Check for null bytes (security)
+        if (trimmed.includes('\0')) {
+            return false;
+        }
+        // Platform-specific validation
+        if (this.isWindows) {
+            return this.isValidWindowsPath(trimmed);
+        }
+        else {
+            return this.isValidUnixPath(trimmed);
+        }
+    }
+    /**
+     * Validates Windows-specific path format
+     */
+    isValidWindowsPath(filePath) {
+        // Check for invalid Windows characters: < > : " | ? *
+        // Note: : is allowed in drive letter position (C:)
+        const invalidCharsRegex = /[<>"|?*]/;
+        // If path has drive letter, check everything after it
+        if (/^[a-zA-Z]:/.test(filePath)) {
+            const pathAfterDrive = filePath.substring(2);
+            if (invalidCharsRegex.test(pathAfterDrive)) {
+                return false;
+            }
+        }
+        else if (invalidCharsRegex.test(filePath)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Validates Unix-specific path format (Mac/Linux)
+     */
+    isValidUnixPath(_filePath) {
+        // Unix paths are generally more permissive
+        // Main check is for null bytes (already done in isValid)
+        return true;
+    }
+    /**
+     * Checks if a path is safe (no directory traversal)
+     * @param filePath - The path to check
+     * @returns true if safe, false otherwise
+     */
+    isSafe(filePath) {
+        // Check for null bytes
+        if (filePath.includes('\0')) {
+            return false;
+        }
+        // Check for directory traversal patterns
+        if (filePath.includes('..')) {
+            return false;
+        }
+        // Additional Windows checks
+        if (this.isWindows) {
+            // Check for reserved device names
+            const reservedNames = /^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])$/i;
+            const pathParts = filePath.split(/[/\\]/);
+            for (const part of pathParts) {
+                if (!part)
+                    continue;
+                const nameWithoutExt = part.split('.')[0];
+                if (reservedNames.test(nameWithoutExt)) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+    /**
+     * Normalizes a file path using platform-specific separators
+     * @param filePath - The path to normalize
+     * @returns Normalized path
+     */
+    normalize(filePath) {
+        if (!filePath) {
+            return '';
+        }
+        // Normalize the path using Node.js path module
+        let normalized = path.normalize(filePath);
+        // Remove trailing slash if present (except for root)
+        if (normalized.length > 1 && normalized.endsWith(path.sep)) {
+            normalized = normalized.slice(0, -1);
+        }
+        return normalized;
+    }
+    /**
+     * Check if path is absolute
+     * Cross-platform compatible
+     */
+    isAbsolute(filePath) {
+        return path.isAbsolute(filePath);
+    }
+}
+exports.PathValidator = PathValidator;
+//# sourceMappingURL=path.validator.js.map

package/dist/domain/validators/path.validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.validator.js","sourceRoot":"","sources":["../../../src/domain/validators/path.validator.ts"],"names":[],"mappings":"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"}

package/dist/domain/validators/url.validator.d.ts

@@ -0,0 +1,19 @@
+/**
+ * URL Validator
+ * Validates URLs and extracts filenames
+ */
+export declare class UrlValidator {
+    /**
+     * Validates if a string is a valid HTTP/HTTPS URL
+     * @param url - The URL to validate
+     * @returns true if valid, false otherwise
+     */
+    isValid(url: any): boolean;
+    /**
+     * Extracts filename from URL
+     * @param url - The URL to extract filename from
+     * @returns The filename or 'download' as default
+     */
+    extractFilename(url: string): string;
+}
+//# sourceMappingURL=url.validator.d.ts.map

package/dist/domain/validators/url.validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.validator.d.ts","sourceRoot":"","sources":["../../../src/domain/validators/url.validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,YAAY;IACvB;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO;IAa1B;;;;OAIG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAarC"}