Skip to content

Conversation

@erayaydin
Copy link
Contributor

@erayaydin erayaydin commented Oct 15, 2025

This PR upgrades the Server SDK to the Server API v4. It removes Server APIv3 specific behavior and aligns the SDK with the new events format shared by Server API and Webhooks.
INTER-1491

❓ Why?

  • Server API v3 is deprecated on Oct 31, 2025 and will be sunset on Oct 31, 2026.
  • v4 standardizes responses (no data/products/result nesting), switches to Bearer auth, unifies Webhooks & Server API event formats, and deprecates /visitors in favor of /v4/events.

⚙️ What Changed?

  • Project name changed from FingerprintPro.ServerSdk to Fingerprint.ServerSdk.

⚠️ Breaking Changes

  • All using directives and type references must change from
    FingerprintPro.ServerSdk to Fingerprint.ServerSdk.
  • If you reference project/solution files (or Docker images by name),
    update them to the new names.

📦 Migration Guide (SDK Consumers)

  • Replace namespace imports:
    • using FingerprintPro.ServerSdk; -> using Fingerprint.ServerSdk;
  • Update any fully-qualified types/references (e.g., .Model.*) to the
    new root namespace.
  • If you run examples/tests via Docker-Compose, rebuild with the new
    image/tag and use the updated docker-compose.yml file.
  • If you reference the solution or project files directly in CI
    pipeline/script, update the paths to Fingerprint.ServerSdk/.

Renamed solution and project artifacts:
- `fingerprint-pro-server-api-dotnet-sdk.sln` to
  `fingerprint-server-dotnet-sdk.sln`.
- `src/FingerprintPro.ServerSdk*` to `src/Fingerprint.ServerSdk*`.
- Updated `*.csproj` names.

Updated namespaces and related code references:
- `FingerprintPro.ServerSdk.*` -> `Fingerprint.ServerSdk.*`
- Adjusted README code samples to use `using Fingerprint.ServerSdk;`

Updated docker image and compose service names to
`fingerprint-server-dotnet-sdk`.

Updated `bumpConfig.mjs` path points to the new
`Fingerprint.ServerSdk.csproj`.

`.swagger-codegen-ignore` paths updated to the new directory.

Changelog title also updated to the new project name.

**BREAKING CHANGE**
- All `using` directives and type references must change from
  `FingerprintPro.ServerSdk` to `Fingerprint.ServerSdk`.
- If you reference project/solution files (or Docker images by name),
  update them to the new names.

**MIGRATION GUIDE**
- Replace namespace imports:
  - `using FingerprintPro.ServerSdk;` -> `using Fingerprint.ServerSdk;`
- Update any fully-qualified types/references (e.g., `.Model.*`) to the
  new root namespace.
- If you run examples/tests via Docker-Compose, rebuild with the new
  image/tag and use the updated `docker-compose.yml` file.
- If you reference the solution or project files directly in CI
  pipeline/script, update the paths to `Fingerprint.ServerSdk/`.

Related-Task: INTER-1491
@erayaydin erayaydin requested a review from necipallef October 15, 2025 15:24
@erayaydin erayaydin self-assigned this Oct 15, 2025
@erayaydin erayaydin added the enhancement New feature or request label Oct 15, 2025
@changeset-bot
Copy link

changeset-bot bot commented Oct 15, 2025

🦋 Changeset detected

Latest commit: 36b646f

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
fingerprint-server-dotnet-sdk Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

Added `set -euo pipefail` for safer and more predictable script behavior
(early fail). Made sure required directories are created before writing
files (current example list doesn't have additional directory). Switched
to `curl -fSL` for better error handling and redirect support.

Related-Task: INTER-1491
@github-actions
Copy link
Contributor

🚀 Following releases will be created using changesets from this PR:

fingerprint-server-dotnet-sdk@8.0.0

Major Changes

  • Rename .NET SDK project and namespaces from FingerprintPro.ServerSdk.* to Fingerprint.ServerSdk.*.

    Breaking changes

    • Update all using directives and fully-qualified type names:
      • FingerprintPro.ServerSdk.*Fingerprint.ServerSdk.*
    • If you reference solution/project file names or CI paths, update them to the new Fingerprint.ServerSdk.* locations. (7af5781)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant