v0.9.9

0.9.9 (2026-05-04)

Added

• oauth2 scopes for authentication (#326) (c02b3cc)
• release automation configs (#312) (dbd003f)
• report a per call http metric (#310) (cc3a5f2)

Fixed

• attach Authorization header to streaming and ApiExecutor requests (#330) (#331) (b09ca16)

What's Changed

• chore: remove maven publish dependencies for publish-github-packages job by @SoulPancake in #335
• chore(deps): bump the dependencies group with 5 updates by @dependabot[bot] in #336
• chore(deps): bump the dependencies group in /examples/opentelemetry with 2 updates by @dependabot[bot] in #337
• chore(deps): bump the dependencies group in /examples/basic-examples with 2 updates by @dependabot[bot] in #338
• chore: fix release pipeline for publish gradle file by @SoulPancake in #339
• release: v0.9.9 by @openfga-releaser-bot[bot] in #340

Full Changelog: v0.9.8...v0.9.9

v0.9.8

0.9.8 (2026-04-30)

Added

• oauth2 scopes for authentication (#326) (c02b3cc)
• release automation configs (#312) (dbd003f)
• report a per call http metric (#310) (cc3a5f2)

Fixed

• attach Authorization header to streaming and ApiExecutor requests (#330) (#331) (b09ca16)

v0.9.7

0.9.7 (2026-03-17)

Added

• Introduced StreamingApiExecutor for executing HTTP requests to streaming endpoints not yet wrapped by the SDK (#296)

Fixed

• fix: share single Telemetry instance per SDK client (#290)
• fix: Socket Badge URL in README.md (#306)

What's Changed

• chore(deps): bump the dependencies group in /examples/basic-examples with 2 updates by @dependabot[bot] in #304
• chore(deps): bump the dependencies group in /examples/opentelemetry with 5 updates by @dependabot[bot] in #303
• chore(deps): bump the dependencies group with 3 updates by @dependabot[bot] in #301
• chore(deps): bump the dependencies group with 2 updates by @dependabot[bot] in #302
• feat: streaming APIExecutor by @SoulPancake in #296
• fix: share single Telemetry instance per SDK client by @jimmyjames in #290
• ci: add PR conventional commits validation by @SoulPancake in #305
• fix: Socket Badge URL in README.md by @SoulPancake in #306
• chore(release): v0.9.7 by @SoulPancake in #307

Full Changelog: v0.9.6...v0.9.7

v0.9.6

0.9.6 (2026-02-18)

Added

• Introduced ApiExecutor for executing custom HTTP requests to OpenFGA API endpoints (#273, #277)

Breaking Changes

• Minimum Java version requirement increased to Java 17 (#282)
• Java 11 support removed (#282)

What's Changed

• feat: APIExecutor for calling raw arbitrary endpoints by @SoulPancake in #273
• chore(deps): bump the dependencies group with 3 updates by @dependabot[bot] in #278
• chore(deps): bump the dependencies group in /examples/opentelemetry with 6 updates by @dependabot[bot] in #281
• chore(deps): bump the dependencies group in /examples/basic-examples with 5 updates by @dependabot[bot] in #280
• chore: refactor HttpMethods to enum by @SoulPancake in #277
• BREAKING CHANGE: Remove Java 11 support by @curfew-marathon in #282
• chore(deps): bump the dependencies group across 1 directory with 5 updates by @dependabot[bot] in #283
• chore: added 'make build' and fixed gradle warning by @aaguiarz in #284
• Chore/upgrade spotless to 8.2.1 by @curfew-marathon in #285
• chore: Add Java 25 to CI build matrix with conditional Spotless skip by @curfew-marathon in #286
• chore: remove spotless check override for Java 25 by @curfew-marathon in #287
• release: v0.9.6 by @SoulPancake in #295

New Contributors

• @curfew-marathon made their first contribution in #282

Full Changelog: v0.9.5...v0.9.6

v0.9.5

0.9.5 (2026-01-27)

Added

• feat: support for streamed list objects (#252, #272)

What's Changed

• chore(deps): bump the dependencies group in /examples/opentelemetry with 5 updates by @dependabot[bot] in #247
• chore: make streamed list objects client layer public by @SoulPancake in #272
• chore(deps): bump the dependencies group with 4 updates by @dependabot[bot] in #268
• chore(deps): bump the dependencies group with 4 updates by @dependabot[bot] in #269
• chore(deps): bump the dependencies group in /examples/opentelemetry with 5 updates by @dependabot[bot] in #270
• chore(deps): bump org.jetbrains.kotlin.jvm from 2.2.21 to 2.3.0 in /examples/basic-examples in the dependencies group by @dependabot[bot] in #271
• chore(deps): bump org.assertj:assertj-core from 3.27.6 to 3.27.7 by @dependabot[bot] in #275
• release: v0.9.5 by @SoulPancake in #274

Full Changelog: v0.9.4...v0.9.5

v0.9.4

0.9.4 (2025-12-05)

Changed

• Improved error handling and integration test coverage for FgaError and related classes. (#260)

v0.9.3

v0.9.3 (2025-11-10)

Fixed

• fix: preserve response headers in transaction write operations (#254)

What's Changed

• docs: update liststores entry to include credit by @ewanharris in #241
• chore: reduce generated code by @rhamzeh in #238
• chore: Added a top-level Makefile in java-sdk to simplify running tests and linters by @Abishek-Newar in #242
• chore(ci): remove FOSSA workflow due to expired API token by @SoulPancake in #250
• fix: preserve response headers for txn writes by @SoulPancake in #254
• release v0.9.3 by @SoulPancake in #255

New Contributors

• @Abishek-Newar made their first contribution in #242

Full Changelog: v0.9.2...v0.9.3

v0.9.2

v0.9.2

0.9.2 (2025-10-23)

Added

• Add support for write conflict options (#234)
  • The SDK now supports setting a onDuplicate for writing tuples (ClientWriteOptions or ClientWriteTuplesOptions) and onMissing (ClientWriteOptions or ClientDeleteTuplesOptions) for deleting tuples. See the documentation for more details.
• Add support for name filter on ListStores (#237)
  • Thanks to @Oscmage and @varkart for their work on this!

v0.9.1

0.9.1 (2025-10-07)

Fixed

• Override defaultHeaders in ClientConfiguration to return correct type when using method (#226)
• Correctly handle options with no modelID set in readAuthorizationModel (#226)
• Include headers when converting from ClientListRelationsOptions to ClientBatchCheckOptions (#226)

v0.9.0

0.9.0 (2025-08-15)

Added

• RFC 9110 compliant Retry-After header support with exponential backoff and jitter
• Retry-After header value exposed in error objects for better observability
• FgaError now exposes Retry-After header value via getRetryAfterHeader() method

ChangeD

• Enhanced retry strategy with delay calculation
• BREAKING: Maximum allowable retry count is now enforced at 15 (default remains 3)
• BREAKING: Configuration.minimumRetryDelay() now requires non-null values and validates input, throwing IllegalArgumentException for null or negative values
• Migration Guide:%0A%0A - Update error handling code if using FgaError properties - new getRetryAfterHeader() method available
• Note: Maximum allowable retries is now enforced at 15 (validation added to prevent exceeding this limit)
• IMPORTANT: Configuration.minimumRetryDelay() now requires non-null values and validates input - ensure you're not passing null or negative Duration values, as this will now throw IllegalArgumentException. Previously null values were silently accepted and would fall back to default behavior at runtime

Fixed

• Fixed issue where telemetry metrics are not being exported correctly #590
• Fixed issue with non-transactional write error handling #573

Feature

• Implements feature to improve the retry strategy #155