browser-debugger-cli/dist/utils/validation.js

DevTools telemetry in your terminal. For humans and agents. Direct WebSocket to Chrome's debugging port.

/**
 * @deprecated This validation module is deprecated. Use `@/commands/shared/validation.ts` instead.
 *
 * Migration guide:
 * - `parseOptionalIntOption()` → `optionalIntRule()` with `validateOptions()`
 * - `parsePositiveIntOption()` → `positiveIntRule()` with `validateOptions()`
 * - `parseIntOption()` → `positiveIntRule()` with custom options
 *
 * The new validation layer provides:
 * - Structured CommandError instances with proper exit codes
 * - Type-safe validation rules
 * - Consistent error formatting
 * - Composable validation patterns
 *
 * @see commands/shared/validation.ts
 */
import { invalidIntegerError } from '../ui/messages/validation.js';
/**
 * Build range options object for error messages.
 *
 * @deprecated Use the new validation layer in `@/commands/shared/validation.ts`
 *
 * @param min - Minimum value
 * @param max - Maximum value
 * @returns Range options object or undefined if no range constraints
 */
function buildRangeOptions(min, max) {
    return min !== undefined && max !== undefined ? { min, max } : undefined;
}
/**
 * Parse and validate an integer option with range constraints.
 *
 * @deprecated Use `positiveIntRule()` from `@/commands/shared/validation.ts` instead
 *
 * @param name - The option name for error messages
 * @param value - The string value to parse (or undefined)
 * @param options - Validation configuration
 * @returns Parsed integer value or undefined if not required and not provided
 * @throws Error if validation fails
 *
 * @example
 * ```typescript
 * // Required with default
 * const lastN = parseIntOption('last', options.last, {
 *   defaultValue: 10,
 *   min: 1,
 *   max: 1000
 * });
 *
 * // Optional
 * const timeout = parseIntOption('timeout', options.timeout, {
 *   required: false,
 *   min: 1,
 *   max: 3600
 * });
 * ```
 */
export function parseIntOption(name, value, options = {}) {
    const { required = true, defaultValue, min, max, errorFormatter } = options;
    const strValue = value ?? (defaultValue !== undefined ? defaultValue.toString() : undefined);
    if (strValue === undefined) {
        if (required) {
            throw new Error(`Option --${name} is required`);
        }
        return undefined;
    }
    const trimmed = strValue.trim();
    const parsed = parseInt(trimmed, 10);
    if (isNaN(parsed)) {
        const errorMessage = errorFormatter?.(value) ?? invalidIntegerError(name, trimmed, buildRangeOptions(min, max));
        throw new Error(errorMessage);
    }
    if ((min !== undefined && parsed < min) || (max !== undefined && parsed > max)) {
        const errorMessage = errorFormatter?.(value) ?? invalidIntegerError(name, trimmed, buildRangeOptions(min, max));
        throw new Error(errorMessage);
    }
    return parsed;
}
/**
 * Parse and validate a positive integer option with range constraints.
 *
 * @deprecated Use `positiveIntRule()` from `@/commands/shared/validation.ts` instead
 *
 * @param name - The option name for error messages
 * @param value - The string value to parse (or undefined)
 * @param options - Validation configuration
 * @returns Parsed integer value
 * @throws Error if validation fails
 *
 * @example
 * ```typescript
 * const lastN = parsePositiveIntOption('last', options.last, {
 *   defaultValue: 10,
 *   min: 1,
 *   max: 1000
 * });
 * ```
 */
export function parsePositiveIntOption(name, value, options = {}) {
    const result = parseIntOption(name, value, { ...options, required: true });
    if (result === undefined) {
        throw new Error(`Option --${name} is required`);
    }
    return result;
}
/**
 * Parse an optional integer option (returns undefined if not provided).
 *
 * @deprecated Use `optionalIntRule()` from `@/commands/shared/validation.ts` instead
 *
 * @param name - The option name for error messages
 * @param value - The string value to parse (or undefined)
 * @param options - Validation configuration
 * @returns Parsed integer or undefined
 * @throws Error if value is provided but invalid
 *
 * @example
 * ```typescript
 * const timeout = parseOptionalIntOption('timeout', options.timeout, {
 *   min: 1,
 *   max: 3600
 * });
 * ```
 */
export function parseOptionalIntOption(name, value, options = {}) {
    return parseIntOption(name, value, { ...options, required: false });
}
//# sourceMappingURL=validation.js.map