CHANGELOG.md

Changelog

v0.4.0

compare changes

⚠️ Behavior changes

• A visit tagged only with utm_id, utm_source_platform, utm_creative_format, utm_marketing_tactic, gad_campaignid, gbraid, wbraid, or dclid now counts as a campaign visit. It is saved even with captureWithoutCampaign: false and can become first or last touch. Entries store these values in utmParams and gclidParams, so an API that rejects unknown keys in getAttribution() payloads needs to accept them (#223)
• New session IDs are 32 hexadecimal characters instead of up to 13 base-36 characters. A tab that already has a session ID keeps it, so history can hold both formats (#222)

🚀 Enhancements

• Capture GA4 campaign parameters and Google click IDs used on iOS and Display & Video 360 (#223)
• Capture click IDs from other ad platforms with the clickParams option (#224)
• Suggest known ad platform click IDs and warn about miscased names (#226)

🩹 Fixes

• deps: Refresh transitive dependencies to patched releases (#215)
• Generate session IDs from 128 cryptographically random bits (#222)
• Capture the router's current route when pages call capture during navigation (#221)

📖 Documentation

• Describe release notes for behavior changes and the tokenless publish workflow (#225)

🏡 Chore

• deps-dev: Bump vitest from 5.0.0 to 5.0.3 (#217)
• Remove package manager settings the toolchain ignores (#219)

✅ Tests

• Consolidate utm helper tests into one suite (#218)

🤖 CI

• Update playwright packages together in dependabot (#214)
• Publish to npm through trusted publishing (#216)
• Make Prettier the only formatter and check formatting in CI (#220)

❤️ Contributors

• Sadjow Leão (@sadjow)

v0.3.1

compare changes

🚀 Enhancements

• Enable the module on Nuxt 5 and later instead of disabling it as incompatible (#211)

🏡 Chore

• deps-dev: Bump @types/node from 26.2.0 to 26.4.0 (#191)
• deps-dev: Bump @nuxt/test-utils from 4.1.0 to 4.2.0 (#192)
• deps-dev: Bump vue from 3.5.41 to 3.5.42 (#195)
• deps-dev: Bump vue-tsc from 3.3.8 to 3.3.11 (#193)
• deps-dev: Bump vue-router from 5.3.0 to 5.3.1 (#194)
• deps-dev: Bump @types/node from 26.4.0 to 26.4.1 (#196)
• deps-dev: Bump eslint from 10.9.1 to 10.10.0 (#197)
• deps-dev: Bump @nuxt/test-utils from 4.2.0 to 4.3.2 (#198)
• deps-dev: Bump vue from 3.5.42 to 3.5.43 (#200)
• deps-dev: Bump playwright from 1.62.1 to 1.63.0 (#201)
• deps-dev: Bump @types/node from 26.4.1 to 26.5.1 (#199)
• deps-dev: Bump hookable from 6.1.1 to 6.1.2 (#202)
• deps-dev: Bump playwright-core from 1.62.1 to 1.63.0 (#205)
• deps-dev: Bump @types/node from 26.5.1 to 26.6.1 (#203)
• deps-dev: Bump prettier from 3.9.6 to 3.9.9 (#204)
• deps-dev: Bump eslint from 10.10.0 to 10.11.0 (#207)
• deps-dev: Bump vue-tsc from 3.3.11 to 3.3.12 (#208)
• deps-dev: Bump vitest from 4.1.11 to 5.0.0 (#209)
• deps-dev: Bump @types/node from 26.6.1 to 26.6.4 (#210)
• deps-dev: Bump @nuxt/test-utils from 4.3.2 to 4.3.3 (#206)
• Describe the package by its lead attribution use case (#212)

❤️ Contributors

• Sadjow Leão (@sadjow)

v0.3.0

compare changes

🚀 Enhancements

• Add capture() and getAttribution() to prepare first-touch, last-touch, and retained visit history for form submissions (#182)
• Add maxAge and maxEntries retention controls, optional route-change tracking, and campaign-only capture (#182)

🩹 Fixes

• deps: Resolve dependency security alerts (#179)
• Publish complete module types (ea5af74)
• Preserve tracking controls across pending hooks (f2dfcc4)

📦 Build

• Use pnpm for the module and playground (98e489a)

🏡 Chore

• deps-dev: Bump nuxt from 4.4.6 to 4.4.7 (#132)
• deps-dev: Bump nuxt from 4.4.6 to 4.4.7 in /playground (#129)
• deps-dev: Bump @nuxt/devtools from 3.2.4 to 3.3.1 (#145)
• deps-dev: Bump nuxt from 4.4.7 to 4.5.1 in /playground (#146)
• Automate safe Dependabot updates (#148)
• deps-dev: Bump playwright from 1.57.0 to 1.62.0 (#151)
• deps-dev: Bump @nuxt/eslint-config from 1.15.2 to 1.16.0 (#152)
• deps-dev: Bump @nuxt/eslint from 1.15.2 to 1.16.0 (#154)
• Test maintained Node.js releases (#149)
• Harden Dependabot auto-merge (#155)
• Auto-merge Dependabot updates after CI (#156)
• deps-dev: Bump eslint from 9.39.4 to 10.7.0 (#150)
• Simplify Dependabot auto-merge (#157)
• deps-dev: Bump nuxt from 4.4.7 to 4.5.1 (#144)
• deps-dev: Bump @nuxt/schema from 4.4.7 to 4.5.1 (#158)
• deps-dev: Bump prettier from 3.8.3 to 3.9.6 (#159)
• deps-dev: Bump vitest from 4.1.5 to 4.1.10 (#160)
• deps-dev: Bump playwright from 1.62.0 to 1.62.1 (#161)
• deps-dev: Bump eslint-plugin-prettier from 5.5.5 to 5.5.6 (#163)
• deps-dev: Bump eslint from 10.7.0 to 10.8.0 (#166)
• deps-dev: Bump @nuxt/devtools from 3.3.1 to 3.4.1 (#164)
• deps-dev: Bump @nuxt/eslint-config from 1.16.0 to 1.17.0 (#165)
• deps-dev: Bump vue-tsc from 2.2.12 to 3.3.8 (#167)
• deps-dev: Bump eslint from 10.8.0 to 10.8.1 (#170)
• deps-dev: Bump @nuxt/eslint from 1.16.0 to 1.17.0 (#169)
• deps-dev: Bump vitest from 4.1.10 to 4.1.11 (#168)
• deps-dev: Bump @nuxt/test-utils from 4.0.3 to 4.1.0 (#171)
• deps-dev: Bump eslint from 10.8.1 to 10.9.0 (#173)
• deps-dev: Bump @nuxt/devtools from 3.4.1 to 3.4.2 (#174)
• deps-dev: Bump typescript from 5.8.3 to 5.9.3 (#172)
• deps-dev: Bump playwright-core from 1.57.0 to 1.62.1 (#162)
• deps-dev: Bump @nuxt/module-builder from 1.0.2 to 1.0.3 (#186)
• deps-dev: Bump vue-router from 5.2.0 to 5.3.0 (5fff2dd)
• deps-dev: Bump nuxt from 4.5.1 to 4.5.2 (06faa9a)
• deps-dev: Bump @types/node from 25.9.6 to 26.2.0 (c351fb5)
• deps-dev: Bump eslint from 10.9.0 to 10.9.1 (0ea6332)

✅ Tests

• Verify packed module on Nuxt static sites (f584dd7)

🤖 CI

• Install matching Playwright browser (#178)

❤️ Contributors

• Sadjow Leão (@sadjow)

v0.2.15

compare changes

🏡 Chore

• deps-dev: Bump nuxt from 4.4.4 to 4.4.6 (#124)
• deps-dev: Bump nuxt from 4.4.4 to 4.4.6 in /playground (#125)

v0.2.14

compare changes

v0.2.13

compare changes

🩹 Fixes

• Add npm publish to release-on-merge workflow (#93)

❤️ Contributors

• Sadjow Leão (@sadjow)

v0.2.12

compare changes

🚀 Enhancements

• Add Nuxt 4 compatibility (#52)
• Add runtime tracking control with privacy features (#54)
• Add release-on-merge workflow for protected branches (#91)

🩹 Fixes

• Npm pre-pack build by removing the clj requiredment (#51)
• deps: Address open security vulnerabilities (#71)

🏡 Chore

• deps-dev: Bump nuxt from 4.0.3 to 4.1.0 (#65)
• deps-dev: Bump nuxt from 4.0.3 to 4.1.0 in /playground (#57)
• deps-dev: Bump playwright from 1.52.0 to 1.57.0 (#58)
• release: V0.2.11 (#90)

❤️ Contributors

• Sadjow Leão (@sadjow)

v0.2.11

compare changes

🚀 Enhancements

• Add Nuxt 4 compatibility (#52)
• Add runtime tracking control with privacy features (#54)

🩹 Fixes

• Npm pre-pack build by removing the clj requiredment (#51)
• deps: Address open security vulnerabilities (#71)

🏡 Chore

• deps-dev: Bump nuxt from 4.0.3 to 4.1.0 (#65)
• deps-dev: Bump nuxt from 4.0.3 to 4.1.0 in /playground (#57)
• deps-dev: Bump playwright from 1.52.0 to 1.57.0 (#58)

❤️ Contributors

• Sadjow Leão (@sadjow)

v0.2.10

compare changes

🩹 Fixes

• Address security vulnerabilities and upgrade Nuxt to v3.17.2 (#49)
• Npm pre-pack build by removing the clj requiredment (954122b)

🏡 Chore

• release: V0.2.8 (0d0e1e3)
• release: V0.2.9 (2e827c2)

❤️ Contributors

• Sadjow Leão (@sadjow)
• Luis David Barrera Díaz hakenprog@gmail.com

v0.2.9

compare changes

🩹 Fixes

• Address security vulnerabilities and upgrade Nuxt to v3.17.2 (#49)
• Npm pre-pack build by removing the clj requiredment (954122b)

🏡 Chore

• release: V0.2.8 (0d0e1e3)

❤️ Contributors

• Sadjow Leão (@sadjow)
• Luis David Barrera Díaz hakenprog@gmail.com

v0.2.8

compare changes

🩹 Fixes

• Address security vulnerabilities and upgrade Nuxt to v3.17.2 (#49)
• Npm pre-pack build by removing the clj requiredment (954122b)

❤️ Contributors

• Sadjow Leão (@sadjow)
• Luis David Barrera Díaz hakenprog@gmail.com

v0.2.7

compare changes

🚀 Enhancements

• Track visits even when UTM parameters are absent (#47)

🏡 Chore

• release: V0.2.6 (80fcf1b)

❤️ Contributors

• Sadjow Leão (@sadjow)

v0.2.6

compare changes

v0.2.5

compare changes

🏡 Chore

• CI: Create workflow to release to NPM (#40)
• CI: Remove yarn publish and use npm publish instead (5b33b32)

❤️ Contributors

• Sadjow Leão (@sadjow)

v0.2.4

compare changes

v0.2.2

compare changes

🚀 Enhancements

• ci: Add yarn lint as a step in the CI (5d988dc)
• ci: Return error if lint warns (41aa042)
• Store The URL of the page the user landed on (8fef662)
• devenv: Setup devenv project development environment. (#25)
• Add playwright as a dev dependency (#33)

🩹 Fixes

• Data Object empty (dba7998)
• Changelog (da24253)
• Usage snippet in the readme (c0852b0)
• Remove not used vars (yarn lint works) (7554ef0)
• doc: Use yarn in Development section (b2e24bc)

💅 Refactors

• Break the code into small functions and create a module for the types (3717aad)
• Rename integration tests and remove unused code (9c65178)
• Move functions to utm.ts file (53cabdd)
• Rename function generateAdditionalInfo (40d11e3)
• UtmData to utm (8ddabe6)

🏡 Chore

• Add unit tests (e95c66d)
• Update description (7ba8ba9)
• Remove playground from pipeline (b4279ea)
• Update github repository description (8feca93)
• Update npm module name on package.json file (ad25ba2)
• Update module version (b0bf42b)
• Add module description (f73d57e)
• release: V0.1.1 (e53a0b9)
• Fix github actions (f2e8b9a)
• Update github actions and add missing integration tests (30e8e9e)
• Typo in integration tests (10eab4e)
• Add @playwright/test and see if we don't need to install it in CI (e8f0655)
• Add @playwright/test and see if we don't need to install it in CI" (e3cfa90)
• release: V0.1.2 (11de53f)
• release: V0.1.3 (5d7cfed)
• Add repository to package json (3a469e3)
• release: V0.1.4 (61169cc)
• Fix repository name (f79dc36)
• release: V0.1.2 (899792e)
• Replace your-org/my-module with stackbuilders/nuxt-utm (20fcd4e)
• Remove unused vars (763f928)
• Update the README (936832e)
• release: V0.1.5 (88312e8)
• release: V0.1.6 (efcfa13)
• release: V0.1.7 (03ec2d6)
• Add keywords to package.json (8e84abc)
• release: V0.1.8 (6fbe62f)
• release: V0.1.9 (c73f5e1)
• Test with playwright container (5b3c216)
• Add status badge to the README (e929e93)
• release: V0.1.10 (ca84ffc)
• Update Readme (#16)
• ci: Add nodejs 20 and remove support for 16 (#26)

❤️ Contributors

• Luis David Barrera Díaz (@hakenprog)
• Sadjow Leão (@sadjow)
• Luis David Barrera (@hakenprog)

v0.1.10

compare changes

🚀 Enhancements

• ci: Return error if lint warns (41aa042)
• Store The URL of the page the user landed on (8fef662)

🩹 Fixes

• Changelog (da24253)
• Usage snippet in the readme (c0852b0)
• Remove not used vars (yarn lint works) (7554ef0)

💅 Refactors

• UtmData to utm (8ddabe6)

🏡 Chore

• Fix repository name (f79dc36)
• release: V0.1.2 (899792e)
• Replace your-org/my-module with stackbuilders/nuxt-utm (20fcd4e)
• Remove unused vars (763f928)
• Update the README (936832e)
• release: V0.1.5 (88312e8)
• release: V0.1.6 (efcfa13)
• release: V0.1.7 (03ec2d6)
• Add keywords to package.json (8e84abc)
• release: V0.1.8 (6fbe62f)
• release: V0.1.9 (c73f5e1)
• Test with playwright container (5b3c216)
• Add status badge to the README (e929e93)

❤️ Contributors

• Luis David Barrera Díaz hakenprog@gmail.com
• Sadjow Leão (@sadjow)
• Luis David Barrera (@hakenprog)

v0.1.9

compare changes

🚀 Enhancements

• ci: Add yarn lint as a step in the CI (5d988dc)

🩹 Fixes

• Data Object empty (dba7998)
• Changelog (da24253)
• Usage snippet in the readme (c0852b0)

💅 Refactors

• Break the code into small functions and create a module for the types (3717aad)
• Rename integration tests and remove unused code (9c65178)
• Move functions to utm.ts file (53cabdd)
• Rename function generateAdditionalInfo (40d11e3)
• UtmData to utm (8ddabe6)

🏡 Chore

• Add unit tests (e95c66d)
• Update description (7ba8ba9)
• Remove playground from pipeline (b4279ea)
• Update github repository description (8feca93)
• Update npm module name on package.json file (ad25ba2)
• Update module version (b0bf42b)
• Add module description (f73d57e)
• release: V0.1.1 (e53a0b9)
• Fix github actions (f2e8b9a)
• Update github actions and add missing integration tests (30e8e9e)
• Typo in integration tests (10eab4e)
• Add @playwright/test and see if we don't need to install it in CI (e8f0655)
• Add @playwright/test and see if we don't need to install it in CI" (e3cfa90)
• release: V0.1.2 (11de53f)
• release: V0.1.3 (5d7cfed)
• Add repository to package json (3a469e3)
• release: V0.1.4 (61169cc)
• Fix repository name (f79dc36)
• release: V0.1.2 (899792e)
• Replace your-org/my-module with stackbuilders/nuxt-utm (20fcd4e)
• Remove unused vars (763f928)
• Update the README (936832e)
• release: V0.1.5 (88312e8)
• release: V0.1.6 (efcfa13)
• release: V0.1.7 (03ec2d6)
• Add keywords to package.json (8e84abc)
• release: V0.1.8 (6fbe62f)

❤️ Contributors

• Sadjow Leão (@sadjow)
• Luis David Barrera dbarrera@stackbuilders.com
• Luis David Barrera Díaz

v0.1.8

compare changes

🚀 Enhancements

• ci: Add yarn lint as a step in the CI (5d988dc)

🩹 Fixes

• Data Object empty (dba7998)
• Changelog (da24253)

💅 Refactors

• Break the code into small functions and create a module for the types (3717aad)
• Rename integration tests and remove unused code (9c65178)
• Move functions to utm.ts file (53cabdd)
• Rename function generateAdditionalInfo (40d11e3)
• UtmData to utm (8ddabe6)

🏡 Chore

• Add unit tests (e95c66d)
• Update description (7ba8ba9)
• Remove playground from pipeline (b4279ea)
• Update github repository description (8feca93)
• Update npm module name on package.json file (ad25ba2)
• Update module version (b0bf42b)
• Add module description (f73d57e)
• release: V0.1.1 (e53a0b9)
• Fix github actions (f2e8b9a)
• Update github actions and add missing integration tests (30e8e9e)
• Typo in integration tests (10eab4e)
• Add @playwright/test and see if we don't need to install it in CI (e8f0655)
• Add @playwright/test and see if we don't need to install it in CI" (e3cfa90)
• release: V0.1.2 (11de53f)
• release: V0.1.3 (5d7cfed)
• Add repository to package json (3a469e3)
• release: V0.1.4 (61169cc)
• Fix repository name (f79dc36)
• release: V0.1.2 (899792e)
• Replace your-org/my-module with stackbuilders/nuxt-utm (20fcd4e)
• Remove unused vars (763f928)
• Update the README (936832e)
• release: V0.1.5 (88312e8)
• release: V0.1.6 (efcfa13)
• release: V0.1.7 (03ec2d6)
• Add keywords to package.json (8e84abc)

❤️ Contributors

• Sadjow Leão (@sadjow)
• Luis David Barrera dbarrera@stackbuilders.com