feat(tolgee): add quarkus-tolgee-service and quarkus-tolgee-hibernate-validator #229

Merged

jorge.bornhausen merged 1 commit from feat/tolgee into main

2026-09-05 13:11:51 +00:00

jorge.bornhausen commented

2026-09-04 22:00:11 +00:00

Owner

quarkus-tolgee-service: in-memory, atomically reloadable Tolgee translation
catalogue for one project. Mandatory config (quarkus.rest-client.tolgee.url,
phoeniqs-oss.tolgee.project-id/api-key), no enabled flag. Dynamic namespace
discovery via used-namespaces, namespace isolation, locale fallback chain
rooted at quarkus.locales/quarkus.default-locale, packaged JSON fallback,
startup survives unavailable Tolgee but fails on missing config. No
request-time network access.
quarkus-tolgee-hibernate-validator: resolves {key} validation message
templates through Tolgee and delegates constraint interpolation back to
Hibernate; request-locale resolution delegated to Quarkus's
locale-resolver-wrapper so Accept-Language handling matches plain Quarkus.
Live recon recorded: structureDelimiter ignored by the reference Tolgee
instance (responses always nested, named namespaces wrapped); default
namespace reported as {id:null, name:null}; unknown languages silently
omitted.
Tests: WireMock-based contract/snapshot suite (31 tests) and validator
integration suite (16 tests). JaCoCo gates: validator 1.00, service 0.98
(documented in AGENTS.md: startup-only guard is not recordable in tests).

- quarkus-tolgee-service: in-memory, atomically reloadable Tolgee translation catalogue for one project. Mandatory config (quarkus.rest-client.tolgee.url, phoeniqs-oss.tolgee.project-id/api-key), no enabled flag. Dynamic namespace discovery via used-namespaces, namespace isolation, locale fallback chain rooted at quarkus.locales/quarkus.default-locale, packaged JSON fallback, startup survives unavailable Tolgee but fails on missing config. No request-time network access. - quarkus-tolgee-hibernate-validator: resolves {key} validation message templates through Tolgee and delegates constraint interpolation back to Hibernate; request-locale resolution delegated to Quarkus's locale-resolver-wrapper so Accept-Language handling matches plain Quarkus. - Live recon recorded: structureDelimiter ignored by the reference Tolgee instance (responses always nested, named namespaces wrapped); default namespace reported as {id:null, name:null}; unknown languages silently omitted. - Tests: WireMock-based contract/snapshot suite (31 tests) and validator integration suite (16 tests). JaCoCo gates: validator 1.00, service 0.98 (documented in AGENTS.md: startup-only guard is not recordable in tests).

jorge.bornhausen added 1 commit

2026-09-04 22:00:11 +00:00

feat(tolgee): add quarkus-tolgee-service and quarkus-tolgee-hibernate-validator

Build / build (pull_request) Successful in 9m13s

Details

50e3cb2f15

- quarkus-tolgee-service: in-memory, atomically reloadable Tolgee translation
  catalogue for one project. Mandatory config (quarkus.rest-client.tolgee.url,
  phoeniqs-oss.tolgee.project-id/api-key), no enabled flag. Dynamic namespace
  discovery via used-namespaces, namespace isolation, locale fallback chain
  rooted at quarkus.locales/quarkus.default-locale, packaged JSON fallback,
  startup survives unavailable Tolgee but fails on missing config. No
  request-time network access.
- quarkus-tolgee-hibernate-validator: resolves {key} validation message
  templates through Tolgee and delegates constraint interpolation back to
  Hibernate; request-locale resolution delegated to Quarkus's
  locale-resolver-wrapper so Accept-Language handling matches plain Quarkus.
- Live recon recorded: structureDelimiter ignored by the reference Tolgee
  instance (responses always nested, named namespaces wrapped); default
  namespace reported as {id:null, name:null}; unknown languages silently
  omitted.
- Tests: WireMock-based contract/snapshot suite (31 tests) and validator
  integration suite (16 tests). JaCoCo gates: validator 1.00, service 0.98
  (documented in AGENTS.md: startup-only guard is not recordable in tests).