adpa-enterprise-framework-automation/dist/commands/utils/validation.js

Modular, standards-compliant Node.js/TypeScript automation framework for enterprise requirements, project, and data management. Provides CLI and API for BABOK v3, PMBOK 7th Edition, and DMBOK 2.0 (in progress). Production-ready Express.js API with TypeSpe

/**
 * Command Validation Utilities
 * Provides validation functions for CLI command inputs
 */
// 1. Node.js built-ins
import { existsSync } from 'fs';
import { join } from 'path';
// 2. Third-party dependencies (none in this file)
// 3. Internal modules (none in this file)
// 4. Constants
import { SUPPORTED_FORMATS } from '../../constants.js';
export class ValidationError extends Error {
    constructor(message) {
        super(message);
        this.name = 'ValidationError';
    }
}
/**
 * Validate output directory path
 */
export function validateOutputDirectory(outputDir) {
    if (!outputDir || typeof outputDir !== 'string') {
        throw new ValidationError('Output directory must be a non-empty string');
    }
    if (outputDir.includes('..')) {
        throw new ValidationError('Output directory cannot contain ".." path segments');
    }
}
/**
 * Validate output format
 */
export function validateFormat(format) {
    if (!SUPPORTED_FORMATS.includes(format)) {
        throw new ValidationError(`Invalid format "${format}". Supported formats: ${SUPPORTED_FORMATS.join(', ')}`);
    }
}
/**
 * Validate retry count
 */
export function validateRetryCount(retries) {
    if (retries < 0) {
        throw new ValidationError('Retries must be non-negative');
    }
    if (retries > 10) {
        throw new ValidationError('Retries cannot exceed 10');
    }
}
/**
 * Validate retry backoff timing
 */
export function validateRetryBackoff(backoff) {
    if (backoff < 0) {
        throw new ValidationError('Retry backoff must be non-negative');
    }
    if (backoff > 60000) {
        throw new ValidationError('Retry backoff cannot exceed 60 seconds');
    }
}
/**
 * Validate document key format
 */
export function validateDocumentKey(key) {
    if (!key || typeof key !== 'string') {
        throw new ValidationError('Document key must be a non-empty string');
    }
    // Basic validation - alphanumeric, hyphens, underscores
    if (!/^[a-zA-Z0-9_-]+$/.test(key)) {
        throw new ValidationError('Document key can only contain letters, numbers, hyphens, and underscores');
    }
}
/**
 * Validate category name
 */
export function validateCategory(category) {
    if (!category || typeof category !== 'string') {
        throw new ValidationError('Category must be a non-empty string');
    }
    // Basic validation - alphanumeric, hyphens, underscores
    if (!/^[a-zA-Z0-9_-]+$/.test(category)) {
        throw new ValidationError('Category can only contain letters, numbers, hyphens, and underscores');
    }
}
/**
 * Validate file path exists
 */
export function validateFileExists(filePath, description = 'File') {
    if (!existsSync(filePath)) {
        throw new ValidationError(`${description} does not exist: ${filePath}`);
    }
}
/**
 * Validate directory exists
 */
export function validateDirectoryExists(dirPath, description = 'Directory') {
    if (!existsSync(dirPath)) {
        throw new ValidationError(`${description} does not exist: ${dirPath}`);
    }
}
/**
 * Validate Git repository exists
 */
export function validateGitRepository(outputDir) {
    const gitDir = join(outputDir, '.git');
    if (!existsSync(gitDir)) {
        throw new ValidationError(`No Git repository found in ${outputDir}. Run 'rga vcs init' to initialize.`);
    }
}
/**
 * Validate URL format
 */
export function validateUrl(url, description = 'URL') {
    try {
        new URL(url);
    }
    catch {
        throw new ValidationError(`Invalid ${description}: ${url}`);
    }
}
//# sourceMappingURL=validation.js.map