{"_id":"erralytics","name":"erralytics","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"erralytics","version":"1.0.0","description":"Lib para rastrear erros HTTP e disparar eventos para ferramentas analíticas (dataLayer ou gtag)","main":"./dist/http-error-tracker.umd.js","scripts":{"build":"webpack --config webpack.config.js","test":"echo \"Error: no test specified\" && exit 1"},"repository":{"type":"git","url":"git+https://github.com/lucianfialho/errAlytics.git"},"keywords":["http","error","tracker","analytics","gtag","dataLayer"],"author":{"name":"Lucian Fialho"},"license":"ISC","bugs":{"url":"https://github.com/lucianfialho/errAlytics/issues"},"homepage":"https://github.com/lucianfialho/errAlytics#readme","devDependencies":{"webpack":"^5.98.0","webpack-cli":"^6.0.1"},"_id":"erralytics@1.0.0","gitHead":"0eeb4485634985b032a48b661acc80f7a7a11422","_nodeVersion":"22.12.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-JfKtohzFA4oenniNWoFwO6nb++d1OFYUyMJie7gvTqHfWtejnyYQ0YoTZEK/ps1EyqR2UnZCgUNXRuwMaVmKGw==","shasum":"b011dd6fffd29f118d80b1b374aa88c043e5c850","tarball":"https://registry.npmjs.org/erralytics/-/erralytics-1.0.0.tgz","fileCount":6,"unpackedSize":8623,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDNE8lkgbX+p8fCEYn9lBkkc5lZNJn69u0M8PCg9fN2oAIgIDFLeA8xzd0mQW4Ujq4ik72tgIh9zzm0DBrATpL+Zbc="}]},"_npmUser":{"name":"lucianfialho","email":"lucian@metricasboss.com.br"},"directories":{},"maintainers":[{"name":"lucianfialho","email":"lucian@metricasboss.com.br"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/erralytics_1.0.0_1740424735686_0.3023193743564172"},"_hasShrinkwrap":false}},"time":{"created":"2025-02-24T19:18:55.685Z","1.0.0":"2025-02-24T19:18:55.869Z","modified":"2025-02-24T19:18:56.182Z"},"maintainers":[{"name":"lucianfialho","email":"lucian@metricasboss.com.br"}],"description":"Lib para rastrear erros HTTP e disparar eventos para ferramentas analíticas (dataLayer ou gtag)","homepage":"https://github.com/lucianfialho/errAlytics#readme","keywords":["http","error","tracker","analytics","gtag","dataLayer"],"repository":{"type":"git","url":"git+https://github.com/lucianfialho/errAlytics.git"},"author":{"name":"Lucian Fialho"},"bugs":{"url":"https://github.com/lucianfialho/errAlytics/issues"},"license":"ISC","readme":"# errAlytics\n\n[![npm version](https://img.shields.io/npm/v/err-alytics.svg)](https://www.npmjs.com/package/err-alytics) [![License: MIT](https://img.shields.io/npm/l/err-alytics.svg)](LICENSE)\n\n**errAlytics** é uma biblioteca leve e flexível para rastrear erros HTTP no navegador. Ela realiza uma requisição HEAD para a URL especificada (ou para a URL atual) e dispara eventos analíticos para ferramentas como o Google Tag Manager (via dataLayer – padrão) ou via gtag, conforme sua configuração.\n\n## Recursos\n\n- **Monitoramento de Erros HTTP**: Suporte para códigos de status comuns, como 400, 401, 403, 404, 408, 429, 500, 502, 503 e 504.\n- **Disparo de Eventos Analíticos**: Integração simples para disparar eventos no `dataLayer` (padrão) ou via `gtag`.\n- **Configuração Personalizável**: Permite sobrescrever o método de rastreamento e customizar os eventos disparados para cada código HTTP.\n- **Compatibilidade UMD**: Bundle gerado em formato UMD para uso em ambientes com módulos (ES/CommonJS) e via CDN.\n\n## Instalação\n\n### Via npm\n\n```bash\nnpm install err-alytics\n```\n\n```bash\npnpm add err-alytics\n```\n\n## Uso\nEm um Projeto com Módulos (ES6/Node)\nImporte a classe e instancie-a, passando (opcionalmente) sua configuração personalizada. Por padrão, o método de rastreamento é o dataLayer.\n\n```javascript\nimport ErrAlytics from 'err-alytics';\n\nconst tracker = new ErrAlytics({\n  // A configuração padrão já abrange:\n  // 400: bad_request, 401: unauthorized, 403: forbidden, 404: page_not_found, 408: request_timeout,\n  // 429: too_many_requests, 500: server_error, 502: bad_gateway, 503: service_unavailable, 504: gateway_timeout\n  // Você pode sobrescrever ou adicionar novas configurações se necessário.\n});\n\n// Rastreia a URL atual (ou passe outra URL como parâmetro)\ntracker.track().then((response) => {\n  console.log('Status verificado:', response.status);\n});\n```\n\n## Usando via CDN\n\n```html\n<!DOCTYPE html>\n<html lang=\"pt-BR\">\n<head>\n  <meta charset=\"UTF-8\">\n  <title>Exemplo errAlytics via CDN</title>\n  <!-- Inclua o bundle UMD da lib -->\n  <script src=\"https://cdn.jsdelivr.net/npm/err-alytics/dist/err-alytics.umd.js\"></script>\n</head>\n<body>\n  <script>\n    // A lib estará disponível globalmente como HttpErrorTracker\n    const tracker = new HttpErrorTracker({\n      // Para usar gtag em vez de dataLayer, basta alterar:\n      // trackingMethod: 'gtag'\n    });\n    tracker.track();\n  </script>\n</body>\n</html>\n```\n\n## TODO\n[] Monitoramento de Erros JavaScript: Implementar uma camada adicional que capture erros JavaScript globais (por exemplo, via window.onerror ou window.addEventListener('error')) e dispare eventos analíticos, integrando essa funcionalidade à lib.","readmeFilename":"README.md"}