takt-solid

O pacote @vskstudio/takt-solid é uma camada leve e compatível com renderização no servidor que integra o núcleo de analytics privativo do Takt em aplicações SolidJS. Ele não modifica o payload nem as garantias de privacidade do núcleo subjacente; apenas torna a API mais nativa ao Solid. Componentes principais: - Componente Takt: posicionado próximo à raiz do aplicativo, inicializa o analytics na montagem, envia uma visualização de página inicial, rastreia navegação SPA e disponibiliza a instância de analytics para a árvore de componentes. - Hook useTakt: resolve a instância ativa de analytics no momento da chamada. Antes da montagem do componente Takt ou durante a renderização no servidor, retorna um objeto no-op que nunca dispara erros, permitindo que eventos sejam chamados com segurança em manipuladores. - Função createTaktEvent e componente TaktEvent: formas declarativas de rastrear eventos de clique sem escrever manipuladores explícitos. Ambas resolvem a instância ativa no momento do clique. - Elemento personalizado takt-analytics: um web component framework-agnostic que pode ser usado em páginas não-Solid. Importar a entrada com efeito colateral registra o elemento sem carregar o runtime do Solid. - Widgets TaktBadge e TaktEmbed: wrappers leves que renderizam uma imagem de badge ou um iframe embed com políticas seguras de sandbox e referrer. - Função createStats: fornece um cliente tipado para a API pública do Takt, permitindo recuperação programática de estatísticas como dados de resumo. A instalação requer pnpm (ou npm/yarn) e as dependências peer solid-js versão 1.8 ou superior e @vskstudio/takt-core versão 0.8.1 ou superior. A configuração é fornecida via props no componente Takt ou atributos no elemento personalizado. As opções incluem domínio, endpoint, rastreamento de links de saída, rastreamento de download de arquivos, rastreamento de navegação SPA, relatório de 404, respeito ao Do Not Track, exclusão de localhost, taxa de amostragem, manipulação de query string, scrubbing de URL e uma chave mestre de ativação. As props são lidas uma única vez na montagem; alterações exigem remontagem. A biblioteca é totalmente compatível com SSR: o componente Takt executa apenas no cliente dentro de onMount, e useTakt retorna um no-op seguro durante a renderização no servidor. Importar o elemento personalizado no servidor é uma operação inócua protegida por uma verificação customElements. Todo o comportamento relacionado à privacidade — como suporte a DNT, exclusão de localhost, tratamento de consentimento e congelamento de payload — é implementado na biblioteca core e não é alterado por este wrapper. Licença: MIT.