feat: add Gmail provider with OAuth2 authentication

[leifermendez]

Que tipo de Pull Request es?

• Mejoras
• Bug
• Docs / tests

Descripción

Se agrega un nuevo proveedor de Gmail (@builderbot/provider-gmail) que permite integrar BuilderBot con Gmail usando autenticación OAuth2.

Características principales

• Autenticación OAuth2: Integración segura con Gmail sin necesidad de contraseñas de aplicación
• Recepción de emails en tiempo real: Polling con seguimiento de historial
• Envío de emails: A través de la API de Gmail
• Soporte nativo de threads: Mantiene conversaciones en hilos de Gmail
• Manejo de adjuntos: Soporte para enviar y recibir archivos
• Detección automática de eventos: Identifica automáticamente imágenes, videos, audios y documentos
• Marcar como leído: Opción para marcar emails como leídos después de procesarlos

Cambios realizados

1. Actualización de configuración del monorepo:

   • Agregado packages/provider-gmail a lerna.json
   • Agregado packages/provider-gmail a package.json

2. Actualización de CLI:

   • Agregada opción "Gmail" con hint "OAuth2" a la lista de proveedores disponibles

3. Nuevo paquete @builderbot/provider-gmail:

   • Implementación completa del proveedor con soporte OAuth2
   • Clase GmailCoreVendor para lógica de Gmail API
   • Clase GmailProvider que extiende ProviderClass
   • Utilidades para parsing de emails y manejo de MIME types
   • Suite completa de tests (498+ líneas de tests)
   • Documentación detallada en README.md

Métodos principales disponibles

• sendMessage(): Enviar emails
• sendMedia(): Enviar emails con adjuntos
• reply(): Responder en threads
• saveFile(): Guardar adjuntos
• getAttachments(): Obtener adjuntos
• isReply(): Verificar si es una respuesta
• getThreadId(): Obtener ID del thread

Configuración requerida

const gmailProvider = createProvider(GmailProvider, {
    email: '[email protected]',
    oauth2: {
        clientId: 'YOUR_CLIENT_ID',
        clientSecret: 'YOUR_CLIENT_SECRET',
        refreshToken: 'YOUR_REFRESH_TOKEN'
    }
})

---

Forma parte de este proyecto:

• Discord
• 𝕏 (Twitter)
• Youtube
• Telegram

https://claude.ai/code/session_011piiJy3GawULwcVB53STnY