takt-solid

El paquete @vskstudio/takt-solid es una capa ligera y segura para el renderizado del lado del servidor (SSR) que integra el núcleo de analíticas respetuosas con la privacidad de Takt en aplicaciones SolidJS. No modifica la carga útil ni las garantías de privacidad del núcleo subyacente; simplemente hace que la API se sienta nativa de Solid. Componentes clave: - Componente Takt: colocado cerca de la raíz de la aplicación, inicializa las analíticas al montarse, envía una vista de página inicial, rastrea la navegación de SPA y proporciona la instancia de analíticas al árbol de componentes. - Hook useTakt: resuelve la instancia de analíticas activa en el momento de la llamada. Antes de que el componente Takt se monte, o durante el renderizado del servidor, devuelve un objeto de no-operación que nunca lanza errores, permitiendo que las llamadas a eventos se coloquen de forma segura en los manejadores. - Función createTaktEvent y componente TaktEvent: formas declarativas de rastrear eventos de clic sin escribir manejadores explícitos. Ambos resuelven la instancia activa al momento del clic. - Elemento personalizado takt‑analytics: un componente web agnóstico al framework que puede usarse en páginas que no sean de Solid. Importar la entrada de efecto secundario registra el elemento sin cargar el tiempo de ejecución de Solid. - Widgets TaktBadge y TaktEmbed: envoltorios ligeros que renderizan una imagen de insignia o un embed de iframe con políticas seguras de sandbox y referrer. - Función createStats: proporciona un cliente tipado para la API pública de Takt, permitiendo la recuperación programática de estadísticas como datos de resumen. La instalación requiere pnpm (o npm/yarn) y las dependencias pares solid‑js versión 1.8 o posterior y @vskstudio/takt-core versión 0.8.1 o posterior. La configuración se suministra a través de props en el componente Takt o atributos en el elemento personalizado. Las opciones incluyen dominio, endpoint, seguimiento de enlaces salientes, seguimiento de descarga de archivos, seguimiento de navegación SPA, reporte de 404, respeto a Do Not Track, exclusión de localhost, tasa de muestreo, manejo de cadenas de consulta, limpieza de URL y un interruptor maestro de habilitación. Las props se leen una vez al montarse; los cambios requieren volver a montar el componente. La librería es totalmente compatible con SSR: el componente Takt solo se ejecuta en el cliente dentro de onMount, y useTakt devuelve un no-op seguro durante el renderizado del servidor. Importar el elemento personalizado en el servidor es un no-op protegido por una comprobación de customElements. Todo el comportamiento relacionado con la privacidad —como el soporte de DNT, la exclusión de localhost, el manejo del consentimiento y la congelación de la carga útil— está implementado en la librería núcleo y no es alterado por este wrapper. Licencia: MIT.