Sobre o projeto

Rybbit SDK For Laravel é um pacote Composer que integra a plataforma de análises open-source e respeitadora da privacidade Rybbit em aplicações Laravel. Fornece uma API nativa do Laravel para rastreamento client-side e server-side. Principais capacidades: - **Diretriz Blade**: A tag `@rybbit` injeta o script de rastreamento do Rybbit nas views, suportando atributos como `data-debounce`, `data-tag`, `data-skip-patterns` e `data-mask-patterns`. - **Rastreamento de eventos do lado do servidor**: O facade `Rybbit` envia visualizações de página, eventos personalizados, métricas de desempenho, cliques externos e erros diretamente para o endpoint `/api/track` do Rybbit a partir do backend. - **Consultas de usuário**: Leia os usuários de um site, encontre perfis individuais de usuário e dispositivos, obtenha contagens diárias de sessões ou exclua dados de usuários rastreados por meio da API de leitura do Rybbit. - **Estatísticas de visão geral**: Recupere KPIs principais, séries temporais agrupadas (diárias/horárias/semanais), contagens de visitantes em tempo real e divisões por dimensões como página, país, navegador, etc. - **Túnel de proxy**: Por padrão, o pacote registra rotas locais que fazem proxy das requisições de rastreamento (script, track, identify, session replay, site config) através do próprio domínio da aplicação, evitando bloqueios de ad-blocker e privacidade do navegador. Os IPs dos clientes são resolvidos a partir de `X-Forwarded-For` e encaminhados. Requisições com falha são retryadas, e dados de session replay utilizam jobs em fila. - **Suporte a testes**: `Rybbit::fake()` substitui o facade por um spy em memória, registrando cada chamada e fornecendo helpers de asserção para todos os métodos de rastreamento e consulta. - **Laravel Boost skill**: Inclui um Agent Skill para o agente de codificação AI do Laravel Boost. A configuração é conduzida por variáveis de ambiente (`RYBBIT_SITE_ID`, `RYBBIT_HOST`, `RYBBIT_API_KEY`, etc.) e um arquivo `config/rybbit.php` publicado. O pacote suporta tanto Rybbit Cloud quanto instâncias self-hosted de Rybbit. A cobertura de recursos inclui incorporação do script, túnel, eventos do lado do servidor e consultas de leitura/usuários; metas, funis, sessões e endpoints de administração não são cobertos.