Merge branch 'main' into chore/INTER-2061-bump-openapi-generator

# Conflicts:
#	gradle/libs.versions.toml

Author: kevinmia

.changeset/active-call.md

@@ -0,0 +1,5 @@
+---
+'java-sdk': minor
+---
+
+**events**: Add `active_call` smart signal to `Event`

.changeset/keyboard-layout-hash.md

@@ -0,0 +1,5 @@
+---
+'java-sdk': minor
+---
+
+**events**: Add `keyboard_layout_hash` to `RawDeviceAttributes`

.changeset/plenty-bumps-glow.md

@@ -0,0 +1,5 @@
+---
+'java-sdk': patch
+---
+
+**dependencies**: Bump Jersey, Jackson, and jakarta-annotation-api to their latest compatible versions

.changeset/raw-device-attributes-battery-charging.md

@@ -0,0 +1,5 @@
+---
+'java-sdk': minor
+---
+
+**events**: Add `battery_charging` field to `RawDeviceAttributes`

.github/workflows/e2e-tests.yml

@@ -11,7 +11,7 @@ jobs:
     outputs:
       version: ${{ steps.version.outputs.version }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
       - name: Read version from config.json
         id: version
         run: echo version=$(node -p "require('./package.json').version") >> $GITHUB_OUTPUT

.github/workflows/functional.yml

@@ -23,7 +23,7 @@ jobs:
         java: [ '11', '17', '21', '25' ]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
         with:
           ref: ${{ github.event.pull_request.head.sha }}
       # Gradle will detect the JVM installation from the ubuntu-latest image and use it

.github/workflows/test.yml

@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     name: Check source code formatting
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
       - run: ./gradlew :sdk:checkFormat :examples:checkFormat --continue
 
   test:
@@ -21,7 +21,7 @@ jobs:
         java: ['11', '17', '21', '25']
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
         # Gradle will detect the JVM installation from the ubuntu-latest image and use it
         # includes execution of unit tests
       - run: ./gradlew build -PjavaVersion=${{ matrix.java }} --stacktrace
@@ -30,7 +30,7 @@ jobs:
     runs-on: ubuntu-latest
     name: Jitpack build smoke test
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
       - run: ./gradlew clean build -PjavaVersion=11 --stacktrace
         env:
           JITPACK: true

.schema-version

@@ -1 +1 @@
-v3.4.2
+v3.5.1

README.md

@@ -18,7 +18,7 @@
 
 # Fingerprint Server API Java SDK
 
-[Fingerprint](https://fingerprint.com/) is a device intelligence platform offering industry-leading accuracy. The Fingerprint Server Java SDK is an easy way to interact with the Fingerprint [Server API](https://dev.fingerprint.com/reference/pro-server-api) from your Java application. You can search, update, and delete identification events.
+[Fingerprint](https://fingerprint.com/) is a device intelligence platform offering industry-leading accuracy. The Fingerprint Server Java SDK is an easy way to interact with the Fingerprint [Server API](https://docs.fingerprint.com/reference/server-api) from your Java application. You can search, update, and delete identification events.
 
 
 *Automatically generated by the [OpenAPI Generator](https://openapi-generator.tech)*
@@ -37,6 +37,11 @@ The following versions of Java are supported
 - Java 21
 - Java 25
 
+We aim to support all Java LTS versions that are still maintained upstream.
+
+> [!NOTE]
+> This package assumes you have a Fingerprint subscription or trial, it is not compatible with the [open-source FingerprintJS](https://github.com/fingerprintjs/fingerprintjs). See our documentation to learn more about the [differences between Fingerprint and the open-source FingerprintJS](https://fingerprint.com/github/).
+
 ## Installation
 
 ### Maven users
@@ -202,7 +207,7 @@ public class FingerprintApiExample {
 
 ## Sealed results
 
-This SDK provides utility methods for decoding [sealed results](https://dev.fingerprint.com/docs/sealed-client-results).
+This SDK provides utility methods for decoding [sealed results](https://docs.fingerprint.com/docs/sealed-client-results).
 ```java
 package com.fingerprint.example;
 
@@ -236,7 +241,21 @@ public class SealedResults {
 ```
 To learn more, see the [Sealed results example](/examples/src/main/java/com/fingerprint/example/SealedResults.java).
 
-## Webhook signature validation
+## Webhooks
+
+### Webhook types
+
+A [webhook](https://dev.fingerprint.com/reference/posteventwebhook) sent by Fingerprint has the same shape as an `Event`. You can deserialize the payload directly into that type using the SDK's own JSON mapper:
+
+```java
+import com.fingerprint.v4.model.Event;
+import com.fingerprint.v4.sdk.JSON;
+
+Event event = JSON.getDefault().getMapper().readValue(webhook, Event.class);
+System.out.println(event.getIdentification().getVisitorId());
+```
+
+### Webhook signature validation
 This SDK provides utility method for verifying the HMAC signature of the incoming webhook request.
 
 Here is an example implementation using Spring Boot:

contributing.md

@@ -8,6 +8,16 @@ Most files in the project are autogenerated by [openapi-generator](https://opena
 - [docs](./docs) - generated documentation for models and [API Client](./docs/FingerprintApi.md).
 - [sdk](./sdk) - automatically generated API client code.
 
+## Commit messages
+
+This project follows the [Conventional Commits](https://www.conventionalcommits.org/) standard. Each commit message should be structured as:
+
+```
+<type>: <description>
+
+[optional body]
+```
+
 ## Code generation and building the SDK
 
 Use the Gradle build to invoke `openapi-generator` and generate the code and documentation:
@@ -18,6 +28,14 @@ Use the Gradle build to invoke `openapi-generator` and generate the code and doc
 
 To download the latest OpenAPI schema from [fingerprintjs/fingerprint-pro-server-api-openapi](https://github.com/fingerprintjs/fingerprint-pro-server-api-openapi), run `./scripts/sync.sh`
 
+### Updating the codegen engine and templates
+
+The generator version is pinned as the `openapi` entry in [gradle/libs.versions.toml](./gradle/libs.versions.toml). To update it:
+
+1. Bump the `openapi` version in that file.
+2. Compare each file in [template](./template) against the matching upstream `java` or `jersey3` generator template at the new version, and merge in any upstream changes the same way you would resolve a merge conflict.
+3. Update the engine and the templates in the same change. Using the new engine with old templates, or the other way around, can break code generation without a clear error.
+
 ## Testing the local source code of the SDK
 
 Use the [./src/examples/java/com/fingerprint/example/FunctionalTests.java](./src/examples/java/com/fingerprint/example/FunctionalTests.java) file to make API requests using the local version of the SDK.