tgram-analytics-js

tgram‑analytics JS SDK est une bibliothèque cliente minimale pour envoyer des événements d'analyse à un serveur tgram‑analytics. Elle s'exécute dans le navigateur en n'utilisant que les API natives, n'a aucune dépendance externe et le fichier construit fait moins de deux kilooctets une fois gzippé, ce qui le rend rapide à charger. Fonctionnalités principales : - Zéro dépendance et une taille de bundle minuscule. - Définitions TypeScript complètes incluses, aucun paquet @types séparé nécessaire. - Conception axée sur la confidentialité : aucune cookie, aucun fingerprinting, respect optionnel du paramètre Do Not Track du navigateur, et identifiants de session stockés uniquement dans sessionStorage. - Suivi automatique des pages vues pour les applications monopage (SPA), avec déduplication des URL consécutives identiques. Fonctionne avec React Router, Vue Router, Next.js, Svelte Kit et tout framework utilisant l'API History. - Suivi manuel des événements via une méthode simple track, prenant en charge les valeurs scalaires et les tableaux de scalaires pour les propriétés multi‑valeurs. - Méthode identify pour associer des propriétés utilisateur persistantes à tous les événements suivants. - Contrôle d'opt‑in/opt‑out pour le consentement utilisateur, avec persistance optionnelle gérée par l'application. - Batching optionnel des événements afin de réduire le nombre de requêtes réseau, configurable par taille maximale du lot et temps d'attente maximal. - Options de configuration pour l'URL du serveur, la gestion automatique des pages vues, le respect du DNT, la collecte de contexte et les identifiants de session personnalisés. - Installation simple via npm ou une balise script plain pour les projets sans étape de build. - API complète : init, track, pageview, identify, opt, flush, reset. - Gestion claire des erreurs pour les formes d'événement invalides et les configurations manquantes. - Licence MIT et ouvert aux contributions. L'utilisation typique consiste à importer l'export par défaut, l'initialiser une fois avec la clé API du projet et l'URL du serveur, puis appeler track chaque fois qu'un événement personnalisé doit être enregistré. Les pages vues sont envoyées automatiquement sauf désactivation. Le SDK inclut également un objet global TGA lorsqu'il est chargé via une balise script, permettant une utilisation immédiate sans système de modules. Les mesures de confidentialité garantissent qu'aucun identifiant persistant n'est stocké au-delà de l'onglet actuel, et le serveur impose une liste blanche de domaines par projet pour empêcher la collecte de données non autorisée. Pour les développeurs, le paquet fournit des scripts de build, une suite de tests, la vérification de types TypeScript, des outils de linting et de formatage, ainsi que des directives de contribution claires. En résumé, le SDK JavaScript tgram‑analytics offre une façon simple et à faible surcharge de collecter des données d'événement tout en respectant la vie privée des utilisateurs et l'ergonomie des développeurs.