{"_id":"@agenus-io/utms","_rev":"7-8d66c147a4748005bcfa2cff6feb79dc","name":"@agenus-io/utms","dist-tags":{"latest":"1.0.5"},"versions":{"1.0.0":{"name":"@agenus-io/utms","version":"1.0.0","keywords":["utms","utm","tracking","analytics","marketing","tracking","analytics","marketing"],"_id":"@agenus-io/utms@1.0.0","maintainers":[{"name":"agenus.io","email":"admin@agenus.com.br"}],"dist":{"shasum":"7bebc10663b899b4b4704275885007f442036b75","tarball":"https://registry.npmjs.org/@agenus-io/utms/-/utms-1.0.0.tgz","fileCount":11,"integrity":"sha512-NEIU4IA1DWO5OM6jqPxKekBwUScUUjTDAxUnb6giCCnYdLwF128EXnz5e8Rfcu/apAwKjMyTGyOFGk657az8eg==","signatures":[{"sig":"MEQCICwGWSmsvYggfNDX9hOv/hRjwTg7C3BWB0V9oUmBr2hUAiBFlPY0rE8F4INa5QvrKbnKOrk3/XNGPPFXANBqr04cKg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":49541},"main":"./dist/index.cjs.js","types":"./dist/index.d.ts","module":"./dist/index.esm.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.esm.js","require":"./dist/index.cjs.js"},"./global":{"default":"./dist/index.global.js"}},"gitHead":"575373254e7fdbeb35821dd4520de1b82453abff","scripts":{"dev":"tsup --watch","lint":"eslint src --ext .ts,.tsx","build":"tsup","clean":"rm -rf .turbo && rm -rf node_modules && rm -rf dist","format":"prettier --write src/**/*.{ts,tsx,js,jsx,json,css,md}","release":"npm run build && changeset publish","version":"changeset version","lint:fix":"eslint src --ext .ts,.tsx --fix","changeset":"changeset","type-check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"agenus.io","email":"admin@agenus.com.br"},"_npmVersion":"10.9.2","description":"Sistema de aplicação e persistência de UTMs e parâmetros de campanha. Garante que os parâmetros de URL (utm_source, gclid, fbclid, etc) sejam aplicados corretamente em links e formulários ao longo da navegação, mesmo em páginas dinâmicas.","directories":{},"_nodeVersion":"22.14.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.2","eslint":"^8.57.0","typescript":"^5.5.4","@changesets/cli":"^2.29.7"},"_npmOperationalInternal":{"tmp":"tmp/utms_1.0.0_1763179799786_0.5222371902464416","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@agenus-io/utms","version":"1.0.1","keywords":["utms","utm","tracking","analytics","marketing","tracking","analytics","marketing"],"_id":"@agenus-io/utms@1.0.1","maintainers":[{"name":"davidpimenta","email":"davidpimanta@gmail.com"},{"name":"agenus.io","email":"admin@agenus.com.br"}],"dist":{"shasum":"29ebdc0d928370e447839211e2b5cc8642422143","tarball":"https://registry.npmjs.org/@agenus-io/utms/-/utms-1.0.1.tgz","fileCount":11,"integrity":"sha512-hYovuke987pDsthvHVpssNE2A3Bg9KV2m1f2q/z5uEi7yuse2h0eQVvh4nnHopuZuG8lWcgUvi2L0UpizucS8Q==","signatures":[{"sig":"MEQCIF64hcjQU2xFVHzzPMxJ7UDKhrVPEuHsx0UQwCIu14dKAiBsxbGuNgVCYXxgFezfv2gzhmVYDjjSwb84lBZKfmi8TA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":49199},"main":"./dist/index.cjs.js","types":"./dist/index.d.ts","module":"./dist/index.esm.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.esm.js","require":"./dist/index.cjs.js"},"./global":{"default":"./dist/index.global.js"}},"gitHead":"78f738d77aeda473e70d12d04d0a125e3348195e","scripts":{"dev":"tsup --watch","lint":"eslint src --ext .ts,.tsx","build":"tsup","clean":"rm -rf .turbo && rm -rf node_modules && rm -rf dist","format":"prettier --write src/**/*.{ts,tsx,js,jsx,json,css,md}","release":"npm run build && changeset publish","version":"changeset version","lint:fix":"eslint src --ext .ts,.tsx --fix","changeset":"changeset","type-check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"agenus.io","email":"admin@agenus.com.br"},"_npmVersion":"10.9.2","description":"Sistema de aplicação e persistência de UTMs e parâmetros de campanha. Garante que os parâmetros de URL (utm_source, gclid, fbclid, etc) sejam aplicados corretamente em links e formulários ao longo da navegação, mesmo em páginas dinâmicas.","directories":{},"_nodeVersion":"22.14.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.2","eslint":"^8.57.0","typescript":"^5.5.4","@changesets/cli":"^2.29.7"},"_npmOperationalInternal":{"tmp":"tmp/utms_1.0.1_1767553357214_0.37461110421413824","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@agenus-io/utms","version":"1.0.2","keywords":["utms","utm","tracking","analytics","marketing","tracking","analytics","marketing"],"_id":"@agenus-io/utms@1.0.2","maintainers":[{"name":"davidpimenta","email":"davidpimanta@gmail.com"},{"name":"agenus.io","email":"admin@agenus.com.br"}],"dist":{"shasum":"4a7e2dab4b1fd0a3934933f1b7dcc1d8cdbdf420","tarball":"https://registry.npmjs.org/@agenus-io/utms/-/utms-1.0.2.tgz","fileCount":11,"integrity":"sha512-SI23rfH5bXySnpN0wbT1LujJziJ5eTLgCuIVwsMt/8i0g7iYkMh6fCTmJZI/T/uWSAamYs1uWkt/6XM+bue+vA==","signatures":[{"sig":"MEUCIGLzKhb6rjs8fEe9hf8ZAVSjo67afLzJi31set+duMPNAiEAn+8nKN+4I0yVZLMZzjLhioRS52oU7XZ7BOOvPcN7D5E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":52955},"main":"./dist/index.cjs.js","types":"./dist/index.d.ts","module":"./dist/index.esm.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.esm.js","require":"./dist/index.cjs.js"},"./global":{"default":"./dist/index.global.js"}},"gitHead":"78f738d77aeda473e70d12d04d0a125e3348195e","scripts":{"dev":"tsup --watch","lint":"eslint src --ext .ts,.tsx","build":"tsup","clean":"rm -rf .turbo && rm -rf node_modules && rm -rf dist","format":"prettier --write src/**/*.{ts,tsx,js,jsx,json,css,md}","release":"npm run build && changeset publish","version":"changeset version","lint:fix":"eslint src --ext .ts,.tsx --fix","changeset":"changeset","type-check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"agenus.io","email":"admin@agenus.com.br"},"_npmVersion":"11.6.2","description":"Sistema de aplicação e persistência de UTMs e parâmetros de campanha. Garante que os parâmetros de URL (utm_source, gclid, fbclid, etc) sejam aplicados corretamente em links e formulários ao longo da navegação, mesmo em páginas dinâmicas.","directories":{},"_nodeVersion":"25.2.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.2","eslint":"^8.57.0","typescript":"^5.5.4","@changesets/cli":"^2.29.7"},"_npmOperationalInternal":{"tmp":"tmp/utms_1.0.2_1774617374764_0.6417905182289732","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@agenus-io/utms","version":"1.0.3","keywords":["utms","utm","tracking","analytics","marketing","tracking","analytics","marketing"],"_id":"@agenus-io/utms@1.0.3","maintainers":[{"name":"davidpimenta","email":"davidpimanta@gmail.com"},{"name":"agenus.io","email":"admin@agenus.com.br"}],"dist":{"shasum":"e9f34db2a486183959289c54cf6cad1a289cf111","tarball":"https://registry.npmjs.org/@agenus-io/utms/-/utms-1.0.3.tgz","fileCount":11,"integrity":"sha512-RRjpERJmIioWrdDpWnYBVkMX+MI+FUA6ffGTHgFClZZ4vjRFt5z/VtZVoDsZ/3UgHnOWy5ekRorYRO0eUC38Kg==","signatures":[{"sig":"MEQCIGAjAYr4qUNJof2+yjSvDPYz2PrtKFafeJS+MuqTlULeAiBa8vDv3nbjm6hICgeClxO5WxqmpX+HNRxPzGyIcXIC8g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60580},"main":"./dist/index.cjs.js","types":"./dist/index.d.ts","module":"./dist/index.esm.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.esm.js","require":"./dist/index.cjs.js"},"./global":{"default":"./dist/index.global.js"}},"gitHead":"78f738d77aeda473e70d12d04d0a125e3348195e","scripts":{"dev":"tsup --watch","lint":"eslint src --ext .ts,.tsx","build":"tsup","clean":"rm -rf .turbo && rm -rf node_modules && rm -rf dist","format":"prettier --write src/**/*.{ts,tsx,js,jsx,json,css,md}","release":"npm run build && changeset publish","version":"changeset version","lint:fix":"eslint src --ext .ts,.tsx --fix","changeset":"changeset","type-check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"agenus.io","email":"admin@agenus.com.br"},"_npmVersion":"11.6.2","description":"Sistema de aplicação e persistência de UTMs e parâmetros de campanha. Garante que os parâmetros de URL (utm_source, gclid, fbclid, etc) sejam aplicados corretamente em links e formulários ao longo da navegação, mesmo em páginas dinâmicas.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"js-cookie":"^3.0.5"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.2","eslint":"^8.57.0","typescript":"^5.5.4","@changesets/cli":"^2.29.7","@types/js-cookie":"^3.0.6"},"_npmOperationalInternal":{"tmp":"tmp/utms_1.0.3_1774620397676_0.8678946421451041","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@agenus-io/utms","version":"1.0.4","keywords":["utms","utm","tracking","analytics","marketing","tracking","analytics","marketing"],"_id":"@agenus-io/utms@1.0.4","maintainers":[{"name":"davidpimenta","email":"davidpimanta@gmail.com"},{"name":"agenus.io","email":"admin@agenus.com.br"}],"dist":{"shasum":"82f92d3a0e00d6d96876bf508e0ba41ac74a6f18","tarball":"https://registry.npmjs.org/@agenus-io/utms/-/utms-1.0.4.tgz","fileCount":11,"integrity":"sha512-3EM6ufJHHgTf6DjYJYHdx7sFqqaiR7Kd58lwqTU5i+DVHCsLAJbKDdI0Sn1TVAqnrl3A6Yl6ZIlcG+M9fcDsgw==","signatures":[{"sig":"MEUCIQCc2drGk9jDFmV/VEIM62j8LK1z3BnUJqAylyNcJhve5wIgPfTDeDGeUyEOV4/R5Jc0etuoC4otJcdrrl7q6n4Nol8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60580},"main":"./dist/index.cjs.js","types":"./dist/index.d.ts","module":"./dist/index.esm.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.esm.js","require":"./dist/index.cjs.js"},"./global":{"default":"./dist/index.global.js"}},"gitHead":"78f738d77aeda473e70d12d04d0a125e3348195e","scripts":{"dev":"tsup --watch","lint":"eslint src --ext .ts,.tsx","build":"tsup","clean":"rm -rf .turbo && rm -rf node_modules && rm -rf dist","format":"prettier --write src/**/*.{ts,tsx,js,jsx,json,css,md}","release":"npm run build && changeset publish","version":"changeset version","lint:fix":"eslint src --ext .ts,.tsx --fix","changeset":"changeset","type-check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"agenus.io","email":"admin@agenus.com.br"},"_npmVersion":"11.6.2","description":"Sistema de aplicação e persistência de UTMs e parâmetros de campanha. Garante que os parâmetros de URL (utm_source, gclid, fbclid, etc) sejam aplicados corretamente em links e formulários ao longo da navegação, mesmo em páginas dinâmicas.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"js-cookie":"^3.0.5"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.2","eslint":"^8.57.0","typescript":"^5.5.4","@changesets/cli":"^2.29.7","@types/js-cookie":"^3.0.6"},"_npmOperationalInternal":{"tmp":"tmp/utms_1.0.4_1774620796139_0.2979125388423425","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@agenus-io/utms","version":"1.0.5","main":"./dist/index.cjs.js","module":"./dist/index.esm.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.esm.js","require":"./dist/index.cjs.js"},"./global":{"default":"./dist/index.global.js"}},"scripts":{"dev":"tsup --watch","build":"tsup","lint":"eslint src --ext .ts,.tsx","lint:fix":"eslint src --ext .ts,.tsx --fix","format":"prettier --write src/**/*.{ts,tsx,js,jsx,json,css,md}","type-check":"tsc --noEmit","prepublishOnly":"npm run build","changeset":"changeset","version":"changeset version","release":"npm run build && changeset publish","clean":"rm -rf .turbo && rm -rf node_modules && rm -rf dist"},"devDependencies":{"@changesets/cli":"^2.29.7","@types/js-cookie":"^3.0.6","eslint":"^8.57.0","tsup":"^8.0.2","typescript":"^5.5.4"},"publishConfig":{"access":"public"},"keywords":["utms","utm","tracking","analytics","marketing","tracking","analytics","marketing"],"dependencies":{"js-cookie":"^3.0.5"},"gitHead":"78f738d77aeda473e70d12d04d0a125e3348195e","_id":"@agenus-io/utms@1.0.5","description":"Sistema de aplicação e persistência de UTMs e parâmetros de campanha. Garante que os parâmetros de URL (utm_source, gclid, fbclid, etc) sejam aplicados corretamente em links e formulários ao longo da navegação, mesmo em páginas dinâmicas.","_nodeVersion":"25.2.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-MWXQEw27vlpdQ1Ih0gLZpSNFNbtrqSEnIOFXGewEh5si0wKYIkH2VQ6ziFNMiWhFEhELy6fwlGodwTEft96Zxw==","shasum":"7f9ec053942204074204f476f74b0592150a5899","tarball":"https://registry.npmjs.org/@agenus-io/utms/-/utms-1.0.5.tgz","fileCount":11,"unpackedSize":56505,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDFyNgN3WNX1G1gd6nLJE33t5ZywX/7gc+WkLf4KwRonAiBMONSnNn2chivsBDHgve8kRbXfnxUQSzMj0O1FZQutHg=="}]},"_npmUser":{"name":"agenus.io","email":"admin@agenus.com.br"},"directories":{},"maintainers":[{"name":"davidpimenta","email":"davidpimanta@gmail.com"},{"name":"agenus.io","email":"admin@agenus.com.br"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/utms_1.0.5_1774621179357_0.834533554021313"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-15T04:09:59.677Z","modified":"2026-03-27T14:19:39.665Z","1.0.0":"2025-11-15T04:09:59.995Z","1.0.1":"2026-01-04T19:02:37.364Z","1.0.2":"2026-03-27T13:16:14.910Z","1.0.3":"2026-03-27T14:06:37.832Z","1.0.4":"2026-03-27T14:13:16.274Z","1.0.5":"2026-03-27T14:19:39.499Z"},"keywords":["utms","utm","tracking","analytics","marketing","tracking","analytics","marketing"],"description":"Sistema de aplicação e persistência de UTMs e parâmetros de campanha. Garante que os parâmetros de URL (utm_source, gclid, fbclid, etc) sejam aplicados corretamente em links e formulários ao longo da navegação, mesmo em páginas dinâmicas.","maintainers":[{"name":"davidpimenta","email":"davidpimanta@gmail.com"},{"name":"agenus.io","email":"admin@agenus.com.br"}],"readme":"# 🏷️ Agenus UTMs Tracker\r\n\r\nSistema de aplicação e persistência de UTMs e parâmetros de campanha. Garante que os parâmetros de URL (utm_source, gclid, fbclid, etc) sejam aplicados corretamente em links e formulários ao longo da navegação, mesmo em páginas dinâmicas.\r\n\r\n[![NPM Version](https://img.shields.io/npm/v/@agenus-io/utms)](https://www.npmjs.com/package/@agenus-io/utms)\r\n\r\n---\r\n\r\n## ✅ Funcionalidades\r\n\r\n- ✅ Captura e persistência de UTMs\r\n- ✅ Aplicação automática em links e formulários\r\n- ✅ Suporte a páginas dinâmicas (SPA)\r\n- ✅ Retry automático para dom changes\r\n- ✅ AutoInit via Script Tag com data-attributes\r\n- ✅ Bloqueio anti-duplicação\r\n- ✅ Modo debug com logs\r\n\r\n---\r\n\r\n## ✅ Instalação\r\n\r\n```bash\r\nnpm install @agenus-io/utms\r\n# ou\r\nyarn add @agenus-io/utms\r\n# ou\r\npnpm add @agenus-io/utms\r\n```\r\n\r\n---\r\n\r\n## ✅ Uso Básico (TypeScript / ESM)\r\n\r\n```typescript\r\nimport { init } from \"@agenus-io/utms\";\r\n\r\ninit({\r\n enabled: true,\r\n debug: true,\r\n delay: 0,\r\n});\r\n```\r\n\r\n---\r\n\r\n## ✅ Uso via CommonJS (CJS)\r\n\r\n```javascript\r\nconst { init } = require(\"@agenus-io/utms\");\r\n\r\ninit({\r\n enabled: true,\r\n debug: true,\r\n delay: 0,\r\n});\r\n```\r\n\r\n---\r\n\r\n## ✅ Uso via Script Tag (AutoInit)\r\n\r\n```html\r\n\r\n\r\n```\r\n\r\nOu usando o export específico:\r\n\r\n```html\r\n\r\n\r\n```\r\n\r\nApós carregar, o tracker estará disponível globalmente como `utms`.\r\n\r\n---\r\n\r\n## ✅ Configuração (`InitProps`)\r\n\r\n| Propriedade | Tipo | Padrão | Descrição |\r\n|---|---|---|---|\r\n| `enabled` | boolean | true | Ativa/desativa o tracker |\r\n| `delay` | number | 0 | Delay antes de iniciar |\r\n| `debug` | boolean | false | Ativa logs no console |\r\n\r\n---\r\n\r\n## ✅ API Pública\r\n\r\n| Função | Descrição |\r\n|---|---|\r\n| `init(config)` | Inicializa o tracker |\r\n| `UTMSInit` | Classe principal |\r\n| `waitForFirstUserInteraction(callback)` | Aguarda interação do usuário |\r\n| `log()` | Logger interno |\r\n\r\n---\r\n\r\n## ✅ Fluxo Interno\r\n\r\n1. Captura UTMs da URL\r\n2. Persiste localmente\r\n3. Aplica UTMs automaticamente em todos os links e formulários\r\n4. Observa DOM dinâmico (SPA)\r\n5. Faz retries periódicos para garantir consistência\r\n\r\n---\r\n\r\n## ✅ Formatos de Build\r\n\r\nO pacote é distribuído em múltiplos formatos:\r\n\r\n- **ESM** (`index.esm.js`) - Para uso com `import`\r\n- **CJS** (`index.cjs.js`) - Para uso com `require`\r\n- **IIFE** (`index.global.js`) - Para uso direto no browser via `