app/utils/helpers.py

import uuid
from datetime import datetime
import re


def generate_id() -> str:
    """Generate a unique UUID string."""
    return str(uuid.uuid4())


def format_timestamp(dt: datetime) -> str:
    """
    Format a datetime object to ISO string.
    
    Args:
        dt: Datetime object
        
    Returns:
        ISO formatted string
    """
    return dt.isoformat()


def parse_json_safely(json_str: str) -> dict:
    """
    Safely parse JSON string.
    
    Args:
        json_str: JSON string to parse
        
    Returns:
        Parsed dictionary or empty dict on error
    """
    import json
    try:
        return json.loads(json_str) if json_str else {}
    except json.JSONDecodeError:
        return {}