Minor Changes

• Behavior bug fixes:

  • Stale automatic useVisitorData requests (when immediate changes from true to false during an automatic request) no longer overwrite state (the result is ignored).
  • Loading state is now correctly synchronized when immediate changes.

  We recommend double-checking that your implementation isn't relying on the previous incorrect behavior when upgrading. (ba26003)

• Add support for React 19 and Next.js 16. The react peer range now accepts >=18 <20. (5307b3b)

Patch Changes

• Bump @fingerprint/agent dependency to ^4.1.2 and drop the fast-deep-equal runtime dependency in favor of an internal cache-key comparison. (87b776f)

Patch Changes

• Sample changeset to test release pipeline (00a7e95)

3.0.0 (2026-01-29)

⚠ BREAKING CHANGES

• The SDK api has changed to match changes introduced in V4 version of the agent.
• The default caching strategy has changed from sessionStorage caching to no caching by default, aligned with the underlying JavaScript agent v4 default.

Features

• add usePromiseStore to prevent duplicate async requests (fb59d7f)
• migrate to v4 version of the agent (36a26ba)
• rename package to @fingerprint/react (4714fdf)

Build System

• deps: use stable 4.0.0 version of the @fingerprint/agent (76a2fec)

3.0.0-test.3 (2026-01-27)

Features

• add usePromiseStore to prevent duplicate async requests (fb59d7f)
• rename package to @fingerprint/react (4714fdf)

Build System

• deps: use stable 4.0.0 version of the @fingerprint/agent (76a2fec)

3.0.0-test.2 (2026-01-06)

Features

• bump @fingerprint/agent to 4.0.0-beta.5 (c5d217d)

3.0.0-test.1 (2025-12-19)

⚠ BREAKING CHANGES

• The SDK api has changed to match changes introduced in V4 version of the agent.

Features

• migrate to v4 version of the agent (36a26ba)

2.7.1 (2025-09-15)

Bug Fixes

• bump @fingerprintjs/fingerprintjs-pro-spa to ^1.3.3 (923d78d)
• rename integration monitoring (a431f58)

Build System

• deps: bump the npm_and_yarn group across 2 directories with 4 updates (3dac3a4)

2.7.0 (2025-06-17)

Features

• bump @fingerprintjs/fingerprintjs-pro-spa to ^1.3.2 (d477427)

Bug Fixes

• getData function should only change when getOptions changes (d02eac0), closes #132

Performance Improvements

• use Object.is comparison before doing deep equals (cd1f70d)

Documentation

• README: mention immediate: false explicitly, improve formatting (f1d03e2)

Build System

• deps: bump next (b0f669a)

2.6.3 (2024-03-21)

Bug Fixes

• set initial isLoading according to config.immediate (3194f33)

Build System

• deps: update dependencies to latest version, now using @fingerprintjs/fingerprintjs-pro-spa@1.3.1 (275e234)

2.6.3-test.2 (2024-03-21)

Bug Fixes

• set initials isLoading according to config.immediate (bf52bd1)