Sobre el proyecto

Rybbit Sdk For Laravel es un paquete de Composer que integra la plataforma de analítica open-source y respetuosa con la privacidad Rybbit en aplicaciones Laravel. Proporciona una API nativa de Laravel tanto para seguimiento del lado del cliente como del servidor. Capacidades principales: - **Directiva Blade**: La etiqueta `@rybbit` inyecta el script de seguimiento de Rybbit en las vistas, admitiendo atributos como `data-debounce`, `data-tag`, `data-skip-patterns` y `data-mask-patterns`. - **Seguimiento server-side de eventos**: El facade `Rybbit` envía página vistas, eventos personalizados, métricas de rendimiento, clics salientes y errores directamente al endpoint `/api/track` de Rybbit desde el backend. - **Consultas de usuario**: Consulta los usuarios del sitio, obtén perfiles individuales y dispositivos, recuenta sesiones diarias o elimina datos de usuario rastreados mediante la API de lectura de Rybbit. - **Estadísticas generales**: Obten KPIs principales, series temporales agrupadas (diarias/horarias/semanales), recuentos de visitantes en vivo y desgloses por dimensión según página, país, navegador, etc. - **Tunnel proxy**: Por defecto, el paquete registra rutas locales que reenvían las solicitudes de seguimiento (script, track, identify, session replay, site config) a través del propio dominio de la aplicación, evitando bloqueos por ad-blockers y privacidad del navegador. Las IPs de los clientes se resuelven desde `X-Forwarded-For` y se reenvían. Las solicitudes fallidas se reintentan y los datos de session replay utilizan queued jobs. - **Soporte de pruebas**: `Rybbit::fake()` reemplaza el facade con un spy en memoria, registrando cada llamada y proporcionando helpers de aserción para todos los métodos de seguimiento y consulta. - **Laravel Boost skill**: Incluye un Agent Skill para el agente de codificación AI de Laravel Boost. La configuración se basa en variables de entorno (`RYBBIT_SITE_ID`, `RYBBIT_HOST`, `RYBBIT_API_KEY`, etc.) y un archivo `config/rybbit.php` publicado. El paquete es compatible con Rybbit Cloud e instancias de Rybbit autoalojadas. La cobertura de funciones incluye incrustar el script, tunelización, eventos server-side y consultas de lectura de usuario; los objetivos, embudos, sesiones y endpoints de administración no están cubiertos.