🤝 Guía de Contribución

Parser falla con stanzas XML vacías

### Descripción
Cuando recibo una stanza vacía, el parser lanza KeyError.

### Pasos para reproducir
1. Conectar con cliente
2. Enviar stanza vacía: `<m/>`
3. Ver error

### Comportamiento esperado
El parser debería ignorar stanzas vacías o lanzar ParseError

### Comportamiento actual
Lanza `KeyError: 'id'` sin mensaje útil

### Entorno
- **OS:** Linux
- **Python:** 3.11
- **SDK Version:** 1.5.2

### Logs

### Descripción
Agregar soporte para reacciones emoji en mensajes

### Motivación
Muchas plataformas modernas soportan reacciones. Sería útil para bots interactivos.

### Ejemplo de uso
```python
client.add_reaction(msg_id, "👍")
client.remove_reaction(msg_id, "👍")

toDus-API/
├── todus/                 # Código principal
│   ├── client/            # Clases de cliente y mixins
│   ├── stanzas/           # Generadores XML
│   ├── cache/             # Sistema de cola
│   ├── parser.py          # Parser XMPP
│   ├── errors.py          # Excepciones
│   └── util.py            # Utilidades
├── tests/                 # Suite de tests
├── docs/                  # Documentación
├── examples/              # Ejemplos
└── pyproject.toml         # Configuración del proyecto

# Todos los tests
python -m pytest -v tests/

# Test específico
python -m pytest tests/test_parser.py::test_parse_message -v

# Con cobertura
pip install pytest-cov
pytest --cov=todus --cov-report=html
# Abre htmlcov/index.html

# Linting
flake8 todus/ tests/ --max-line-length=120

# Type checking
pip install mypy
mypy todus/

# Formateo
pip install black
black todus/ tests/

# Buen commit
git commit -m "fix: parser maneja stanzas vacías correctamente

- Añade validación en parse_todus_message()
- Lanza ParseError en lugar de KeyError
- Añade test para stanza vacía
- Refs #123"

# No tan bueno
git commit -m "fix stuff"
git commit -m "updated parser and other things"

## Descripción
Arregla el bug donde el parser falla con stanzas vacías

## Tipo de cambio
- [x] Bug fix
- [ ] Feature nueva
- [ ] Breaking change
- [ ] Documentación

## Testing
- [x] Agregué tests
- [x] Los tests pasan
- [x] Cobertura >= 80%

## Checklist
- [x] Mi código sigue el estilo del proyecto
- [x] Ejecuté pytest y pasó
- [x] Actualicé la documentación
- [x] No hay warnings/errores

## Screenshots (si aplica)

# Clases: PascalCase
class ToDusClient:
    pass

# Funciones y métodos: snake_case
def send_message(phone, body):
    pass

# Constantes: UPPER_CASE
XMPP_HOST = "im.todus.cu"

# Variables privadas: _leading_underscore
def _internal_method(self):
    pass

def send_message(self, to_phone: str, body: str, reply_to_id: str = "") -> str:
    """Envía un mensaje de texto.

    Envía un mensaje privado a través del protocolo XMPP.

    Args:
        to_phone: Número de teléfono del destinatario (formato 53XXXXXXXX)
        body: Texto del mensaje
        reply_to_id: ID del mensaje al que responder (opcional)

    Returns:
        El ID del mensaje enviado

    Raises:
        ConnectionLostError: Si la conexión XMPP se pierde
        TokenExpiredError: Si el token ha expirado

    Examples:
        >>> client = ToDusClient2("5312345678", "password")
        >>> client.login()
        >>> msg_id = client.send_message("5387654321", "¡Hola!")
    """

from typing import Optional, List, Dict

def send_to_many(
    self,
    phones: List[str],
    message: str,
    delay: Optional[float] = None
) -> Dict[str, bool]:
    """Enviar a múltiples destinatarios."""
    pass

import json
import logging
from typing import Optional

import requests
from pysocks import ProxyError

from todus.errors import ConnectionLostError
from todus.util import normalize_phone

# Instalar mkdocs
pip install mkdocs-material

# Previsualizar
mkdocs serve  # Abre http://localhost:8000

# Compilar documentación
mkdocs build