"""Shared utility functions"""
import uuid
from typing import Any


def validate_uuid(value: str) -> str:
    """Validate UUID format and return the value"""
    try:
        uuid.UUID(value)
        return value
    except ValueError:
        raise ValueError(f"Invalid UUID format: {value}")


def truncate_string(value: str, max_length: int = 100) -> str:
    """Truncate string to specified length"""
    if len(value) <= max_length:
        return value
    return value[:max_length]


def sanitize_for_logging(value: str) -> str:
    """Sanitize string for logging (remove sensitive info)"""
    # Remove common sensitive patterns
    import re
    value = re.sub(r'[^a-zA-Z0-9\s\-_.,:;!?\'"]', '', value)
    return value[:200]  # Limit length for log safety