[INTER-1708] Add support for Agent V4

[TheUnderScorer]

This PR adds support for Agent V4.

List of changes

• Removed dependency of the SPA library
• Renamed package to @fingerprint/react
• Renamed FpjsProvider to FingerprintProvider
• Simplified API
• Updated examples to reflect API changes
• Migrated from rollup and jest to vite and vitest for improved DX

Simplified API

FingerprintProvider now accepts all props that are accepted by agent, without additional nesting with loadOptions.

- import { FpjsProvider, FingerprintJSPro } from '@fingerprintjs/fingerprintjs-pro-react
+ import { FingerprintProvider, Fingerprint } from '@fingerprint/react'

- <FpjsProvider
-      loadOptions={{
-        apiKey: "<PUBLIC_API_KEY>",
-        endpoint: [
-          // "https://metrics.yourwebsite.com", 
-          FingerprintJSPro.defaultEndpoint
-        ],
-        scriptUrlPattern: [
-          // "https://metrics.yourwebsite.com/web/v<version>/<apiKey>/loader_v<loaderVersion>.js",
-          FingerprintJSPro.defaultScriptUrlPattern
-        ],
-      }}
-    >
+ <FingerprintProvider apiKey="<PUBLIC_API_KEY>" endpoints={["https://metrics.yourwebsite.com"]}>

useVisitorData now accept only one parameter UseVisitorDataOptions:

- import { useVisitorData } from '@fingerprintjs/fingerprintjs-pro-react
+ import { useVisitorData } from '@fingerprint/react'

- const { data, getData } = useVisitorData({ timeout: 1000, ignoreCache: true }, { immediate: false })

+ // `immediate` can now be configured in a first parameter
+ // `ignoreCache` parameter is no longer available, cache can be configured on the provider level instead
+ const { data, getData } = useVisitorData({ timeout: 1000, immediate: false })

Migration guide

Migration guide will be available in our docs.

[github-actions]

This PR will create a major release 🚀

3.0.0 (2026-01-29)

⚠ BREAKING CHANGES

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

Features

• add usePromiseStore to prevent duplicate async requests (fb59d7f)
• bump @fingerprint/agent to 4.0.0-beta.5 (c5d217d)
• 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)

[fingerprint-dx-team]

🎉 This PR is included in version 3.0.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

[fingerprint-dx-team]

🎉 This PR is included in version 3.0.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

[fingerprint-dx-team]

🎉 This PR is included in version 3.0.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀