release: 5.0.0

[stainless-app]

Automated Release PR

5.0.0 (2025-04-08)

Full Changelog: v4.2.0...v5.0.0

⚠ BREAKING CHANGES

• client: refactor exception structure and methods (#505)
• client: refactor multipart formdata impl (#473)

Features

• api: add new endpoints for pay statement items (#526) (1ab19a3)
• api: api update (#513) (5849824)
• api: api update (#515) (dffd823)
• api: api update (#517) (0123042)
• api: api update (#520) (a6b3092)
• api: api update (#523) (842bb3f)
• api: manual updates (#477) (83f00bd)
• api: manual updates (#527) (b5a2343)
• client: accept InputStream and Path for file params (#479) (721cd2c)
• client: add enum validation method (1bd0c25)
• client: allow configuring timeouts granularly (#470) (4d3b414)
• client: detect binary incompatible jackson versions (#480) (fcf521a)
• client: expose request body setter and getter (#524) (1b97fe6)
• client: make datetime deserialization more lenient (#522) (c7265b7)
• client: make union deserialization more robust (#521) (1bd0c25)
• client: support a lower jackson version (#512) (2897011)
• client: support raw response access (#471) (481c99c)
• client: throw on incompatible jackson version (2897011)
• generate and publish docs (#481) (c5c4196)

Bug Fixes

• client: don't call validate() during deserialization if we don't have to (#516) (e988e9d)
• client: limit json deserialization coercion (#518) (0bd7dd5)
• client: map deserialization bug (8d03e6d)
• client: return Optional<T> instead of Optional<? extends T> (#529) (8b601dc)
• client: support kotlin 1.8 runtime (#502) (0fb2cbc)
• compilation error (ebc6f30)
• pluralize list response variables (#519) (17c4e8f)
• tests: fix jackson attributes (3ccd785)

Performance Improvements

• client: cached parsed type in HttpResponseFor (#525) (16616bf)

Chores

• client: expose Optional, not nullable, from ClientOptions (#476) (fc827bc)
• client: refactor exception structure and methods (#505) (4be4f06)
• client: refactor multipart formdata impl (#473) (7cb2a7f)
• client: remove unnecessary json state from some query param classes (1bd0c25)
• internal: add .kotlin to .gitignore (#483) (473058a)
• internal: add generated comment (#496) (9543169)
• internal: add invalid json deserialization tests (1bd0c25)
• internal: add json roundtripping tests (1bd0c25)
• internal: add some tests for union classes (#501) (4aff498)
• internal: codegen related update (60e5c13)
• internal: codegen related update (#469) (a308954)
• internal: codegen related update (#488) (5742de2)
• internal: codegen related update (#504) (9be38e0)
• internal: codegen related update (#531) (433f15a)
• internal: delete duplicate tests (d1b1bd2)
• internal: delete unused methods and annotations (#514) (8d03e6d)
• internal: don't use JvmOverloads in interfaces (0d38744)
• internal: fix example formatting (#508) (89c25c1)
• internal: generate more tests (35fd786)
• internal: make multipart assertions more robust (f0417a8)
• internal: make test classes internal (#495) (2048a6a)
• internal: reenable warnings as errors (#485) (0d38744)
• internal: refactor enum query param serialization (#503) (8894d83)
• internal: refactor query param serialization impl and tests (#498) (6da412b)
• internal: refactor some test assertions (d1b1bd2)
• internal: reformat some tests (#500) (35fd786)
• internal: remove unnecessary assertNotNull calls (f0417a8)
• internal: remove unnecessary import (#509) (4b12e68)
• internal: rename getPathParam (#499) (d1b1bd2)
• internal: reorder some params methodsc (d1b1bd2)
• internal: swap from getNullable to getOptional (#528) (70033bd)
• internal: use getOrNull instead of orElse(null) (#484) (9c0806b)
• tests: improve enum examples (#532) (775392d)

Documentation

• add build method comments (#497) (d199989)
• add comments to JsonField classes (8b601dc)
• add raw response readme documentation (#474) (81a5824)
• deduplicate and refine comments (#494) (651b10e)
• document JsonValue construction in readme (#487) (e790ad5)
• document how to forcibly omit required field (7989f32)
• minor readme tweak (#511) (12e8d47)
• note required fields in builder javadoc (#475) (2d0c4c8)
• refine comments on multipart params (#507) (f0417a8)
• revise readme docs about nested params (#486) (3682e62)
• swap examples used in readme (#530) (7989f32)
• update readme exception docs (#510) (949341a)
• update URLs from stainlessapi.com to stainless.com (#467) (238b853)

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

[stainless-app]

🤖 Release is at https://github.com/Finch-API/finch-api-java/releases/tag/v5.0.0 🌻