Skip to content

v1.0.0

Choose a tag to compare

@shawn-tsanet shawn-tsanet released this 28 Aug 18:29
· 336 commits to main since this release
2d38f4a

connect-library 1.0.0

Major version: the library moves from Spring Boot 3.3.4 / Jackson 2 to Spring Boot 4.1.1 / Jackson 3. Spring Boot 3.3 is past both OSS end-of-life (2025-06-30) and commercial extended support (2026-06-30); 4.1 is the current OSS-supported line. Estate tracking: tsanetgit/Fin-Intercom_App#76.

Breaking changes for consumers

  1. Jackson 3 coordinates. The library's Jackson dependency is now tools.jackson.core:jackson-databind. Consuming applications must be on Jackson 3 (com.fasterxml.jackson.annotation is unchanged — annotations kept their package).
  2. Unchecked parse exceptions. Jackson 3's JacksonException extends RuntimeException; Jackson 2's JsonProcessingException extended IOException. Any catch (IOException) around mapper calls still compiles but silently stops catching malformed JSON — sweep for this when upgrading.
  3. JsonNullable accessors removed from CaseApprovalUpdateDTO and CollaborationRequestSubmitterUpdateDTO (openApiNullable=false; jackson-databind-nullable has no Jackson 3 release). Plain accessors are unchanged: getCaseNumber() still returns String. Grep across all known consumers found zero uses of the removed _JsonNullable variants.
  4. Stricter primitive handling by default. Jackson 3 enables FAIL_ON_NULL_FOR_PRIMITIVES. The library's own cache read-back mapper is configured to keep Jackson 2 semantics (old cache rows still load), but consumers' own mappers inherit the strict default unless they set it themselves.
  5. jackson-datatype-jsr310 no longer declared — Jackson 3 folds java.time support into databind itself.

Unchanged

  • Public API signatures: no Jackson types leak into public method signatures; all facades unchanged.
  • CacheRetention.sweep() (added in 0.2.0) and the full storage schema.
  • Webhook signature verification, OAuth client-credentials flow, all lifecycle facades.

Verification

Full reactor green with test counts identical to the 0.2.0 baseline (94 connect-library tests). Both downstream consumers (tsanetgit/Connect_Gateway#34, tsanetgit/Fin-Intercom_App#77) compiled and ran their suites against this exact code pre-release. QA: independent separate-session review on #67; one regression found and fixed pre-merge (unpublished CLI module).