@adverant-nexus/cli 2.0.0

package/dist/utils/validation.js

@@ -0,0 +1,289 @@
+/**
+ * Input validation utilities for nexus-cli
+ * Provides robust validation with clear error messages
+ */
+/**
+ * RFC 5322 compliant email regex (simplified but robust)
+ * Validates:
+ * - Local part: alphanumeric + allowed special chars (. _ % + -)
+ * - @ symbol required
+ * - Domain: alphanumeric + hyphens, must have TLD
+ * - TLD: 2-6 characters (covers .com, .io, .museum, etc.)
+ */
+const EMAIL_REGEX = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,6}$/;
+/**
+ * Validates email format according to RFC 5322 simplified
+ *
+ * @param email - Email address to validate
+ * @returns true if valid, error message string if invalid
+ *
+ * @example
+ * ```typescript
+ * validateEmail('user@example.com') // true
+ * validateEmail('invalid.email') // 'Invalid email format. Expected: user@domain.com'
+ * validateEmail('') // 'Email address is required'
+ * ```
+ */
+export function validateEmail(email) {
+    // Check required
+    if (!email || email.trim().length === 0) {
+        return 'Email address is required';
+    }
+    const trimmed = email.trim();
+    // Check length (RFC 5321: max 320 characters)
+    if (trimmed.length > 320) {
+        return 'Email address is too long (max 320 characters)';
+    }
+    // Check format
+    if (!EMAIL_REGEX.test(trimmed)) {
+        return 'Invalid email format. Expected: user@domain.com';
+    }
+    // Additional sanity checks
+    const [localPart, domain] = trimmed.split('@');
+    // Local part max 64 characters (RFC 5321)
+    if (localPart.length > 64) {
+        return 'Email local part is too long (max 64 characters before @)';
+    }
+    // Domain part max 255 characters (RFC 5321)
+    if (domain.length > 255) {
+        return 'Email domain is too long (max 255 characters after @)';
+    }
+    // Check for consecutive dots (invalid per RFC)
+    if (trimmed.includes('..')) {
+        return 'Email cannot contain consecutive dots';
+    }
+    // Check for leading/trailing dots in local part
+    if (localPart.startsWith('.') || localPart.endsWith('.')) {
+        return 'Email local part cannot start or end with a dot';
+    }
+    return true;
+}
+/**
+ * Type guard to check if validation result is an error
+ */
+export function isValidationError(result) {
+    return typeof result === 'string';
+}
+/**
+ * Validates plugin name format
+ *
+ * Requirements:
+ * - Lowercase alphanumeric and hyphens only
+ * - Must start with a letter
+ * - Must not end with a hyphen
+ * - Length: 3-50 characters
+ *
+ * @param name - Plugin name to validate
+ * @returns true if valid, error message string if invalid
+ */
+export function validatePluginName(name) {
+    if (!name || name.trim().length === 0) {
+        return 'Plugin name is required';
+    }
+    const trimmed = name.trim();
+    // Check length
+    if (trimmed.length < 3) {
+        return 'Plugin name must be at least 3 characters';
+    }
+    if (trimmed.length > 50) {
+        return 'Plugin name must be at most 50 characters';
+    }
+    // Check format: lowercase alphanumeric and hyphens
+    const nameRegex = /^[a-z][a-z0-9-]*[a-z0-9]$/;
+    if (!nameRegex.test(trimmed)) {
+        return 'Plugin name must start with a letter, contain only lowercase letters, numbers, and hyphens, and not end with a hyphen';
+    }
+    // Check for consecutive hyphens
+    if (trimmed.includes('--')) {
+        return 'Plugin name cannot contain consecutive hyphens';
+    }
+    return true;
+}
+/**
+ * Validates semantic version format
+ *
+ * Format: major.minor.patch (e.g., 1.0.0)
+ * Supports pre-release tags: 1.0.0-alpha, 1.0.0-beta.1
+ *
+ * @param version - Version string to validate
+ * @returns true if valid, error message string if invalid
+ */
+export function validateSemanticVersion(version) {
+    if (!version || version.trim().length === 0) {
+        return 'Version is required';
+    }
+    const trimmed = version.trim();
+    // Semantic versioning regex (supports pre-release tags)
+    const semverRegex = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
+    if (!semverRegex.test(trimmed)) {
+        return 'Invalid semantic version format. Expected: major.minor.patch (e.g., 1.0.0)';
+    }
+    return true;
+}
+/**
+ * Validates URL format
+ *
+ * @param url - URL string to validate
+ * @returns true if valid, error message string if invalid
+ */
+export function validateUrl(url) {
+    if (!url || url.trim().length === 0) {
+        return 'URL is required';
+    }
+    const trimmed = url.trim();
+    try {
+        const parsed = new URL(trimmed);
+        // Must be HTTP or HTTPS
+        if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+            return 'URL must use HTTP or HTTPS protocol';
+        }
+        return true;
+    }
+    catch {
+        return 'Invalid URL format. Expected: https://example.com';
+    }
+}
+/**
+ * Validates file path exists
+ */
+export function validateFilePath(path, requireExists = true) {
+    if (!path || path.trim().length === 0) {
+        return 'File path is required';
+    }
+    if (!requireExists) {
+        return true;
+    }
+    // Note: This is a synchronous check - in real implementation use fs.existsSync
+    // For now, just validate the format
+    const trimmed = path.trim();
+    // Check for invalid characters (basic check)
+    if (trimmed.includes('\0')) {
+        return 'File path contains invalid null character';
+    }
+    return true;
+}
+/**
+ * Validates directory path exists
+ */
+export function validateDirectoryPath(path, requireExists = true) {
+    if (!path || path.trim().length === 0) {
+        return 'Directory path is required';
+    }
+    if (!requireExists) {
+        return true;
+    }
+    const trimmed = path.trim();
+    // Check for invalid characters (basic check)
+    if (trimmed.includes('\0')) {
+        return 'Directory path contains invalid null character';
+    }
+    return true;
+}
+/**
+ * Validates JSON string
+ */
+export function validateJSON(json) {
+    if (!json || json.trim().length === 0) {
+        return 'JSON string is required';
+    }
+    try {
+        JSON.parse(json);
+        return true;
+    }
+    catch (error) {
+        return `Invalid JSON format: ${error instanceof Error ? error.message : 'Unknown error'}`;
+    }
+}
+/**
+ * Validates required field
+ */
+export function validateRequired(value, fieldName = 'Value') {
+    if (value === undefined || value === null || value === '') {
+        return `${fieldName} is required`;
+    }
+    return true;
+}
+/**
+ * Validates string length
+ */
+export function validateLength(value, min, max, fieldName = 'Value') {
+    if (min !== undefined && value.length < min) {
+        return `${fieldName} must be at least ${min} characters`;
+    }
+    if (max !== undefined && value.length > max) {
+        return `${fieldName} must be at most ${max} characters`;
+    }
+    return true;
+}
+/**
+ * Validates number range
+ */
+export function validateRange(value, min, max, fieldName = 'Value') {
+    if (min !== undefined && value < min) {
+        return `${fieldName} must be at least ${min}`;
+    }
+    if (max !== undefined && value > max) {
+        return `${fieldName} must be at most ${max}`;
+    }
+    return true;
+}
+/**
+ * Validates one of choices
+ */
+export function validateChoice(value, choices, fieldName = 'Value') {
+    if (!choices.includes(value)) {
+        return `${fieldName} must be one of: ${choices.join(', ')}`;
+    }
+    return true;
+}
+/**
+ * Validates array
+ */
+export function validateArray(value, minLength, maxLength, fieldName = 'Value') {
+    if (!Array.isArray(value)) {
+        return `${fieldName} must be an array`;
+    }
+    if (minLength !== undefined && value.length < minLength) {
+        return `${fieldName} must have at least ${minLength} items`;
+    }
+    if (maxLength !== undefined && value.length > maxLength) {
+        return `${fieldName} must have at most ${maxLength} items`;
+    }
+    return true;
+}
+/**
+ * Validates positive number
+ */
+export function validatePositive(value, fieldName = 'Value') {
+    if (value <= 0) {
+        return `${fieldName} must be positive`;
+    }
+    return true;
+}
+/**
+ * Validates port number
+ */
+export function validatePort(port) {
+    if (!Number.isInteger(port)) {
+        return 'Port must be an integer';
+    }
+    if (port < 1 || port > 65535) {
+        return 'Port must be between 1 and 65535';
+    }
+    return true;
+}
+/**
+ * Combines multiple validators
+ */
+export function combineValidators(...validators) {
+    return (value) => {
+        for (const validator of validators) {
+            const result = validator(value);
+            if (result !== true) {
+                return result;
+            }
+        }
+        return true;
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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