Skip to content

CHANGELOG.md

Latest commit

 

History

History
67 lines (54 loc) · 3.47 KB

CHANGELOG.md

File metadata and controls

67 lines (54 loc) · 3.47 KB
Raw

Changelog

All notable changes to com.babelqueue:babelqueue-spring are documented here.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning. The envelope wire format is versioned separately by meta.schema_version (currently 1) — see the contract at babelqueue.com.

Unreleased

Added

  • OpenTelemetry traceparent transport wiring (ADR-0028, v0.2). BabelQueuePublisher gains publishWithHeaders(Envelope, Map<String,String>) — the produce-side seam the optional core com.babelqueue.otel.HeaderSender wires to: it sends through a MessagePostProcessor that writes out-of-band headers (e.g. a W3C traceparent) onto the AMQP MessageProperties headers beside the contract x-* headers (SpringHeaders.apply: a contract header always wins a key collision), never inside the frozen envelope (GR-1). New SpringHeaders.of(Message) / of(MessageProperties) surface a delivered message's headers as a Map<String,String>, the consume-side seam a @RabbitListener wires to Tracing.wrapHandler(tracer, handler, Supplier), so a carried traceparent makes the consumer span a true child of the producer span. A header-less publish is equivalent to before; trace_id is preserved (GR-4); schema_version stays 1. No new runtime dependency — the header seam is a plain Map<String,String>; OpenTelemetry is needed only by callers who opt in.

Changed

  • Require com.babelqueue:babelqueue-core 1.5.0 (the out-of-band header-carrier seam).

1.0.0 - 2026-06-07

1.0.0 — the public API is now SemVer-stable: breaking changes require a MAJOR, following the deprecation policy. The wire envelope is unchanged (schema_version: 1). Full reference at babelqueue.com.

Changed

  • Require com.babelqueue:babelqueue-core 1.0.0.

Internal

  • Build adds JaCoCo (line-coverage gate ≥90%, bound to verify) and SpotBugs (effort=Max, threshold=Medium, spotbugs-exclude.xml for the read-only-envelope EI_EXPOSE patterns); both run in CI via mvn verify. Added a BabelQueuePublisher(PolyglotMessage) test to clear the gate.

0.1.0 - 2026-06-06

Added

  • BabelQueueMessageConverter — a Spring AMQP MessageConverter that encodes the canonical BabelQueue envelope on produce (with the contract AMQP properties: type = URN, correlationId = trace_id, messageId = meta.id, x-schema-version / x-source-lang / x-attempts) and decodes it on consume, returning a core Envelope. Rejects non-conformant messages.
  • BabelQueuePublisher — ergonomic producer over RabbitTemplate (publish(urn, data, queue) / publish(PolyglotMessage)).
  • BabelQueueAutoConfiguration — Spring Boot auto-configuration exposing the converter (so Boot wires it into the RabbitTemplate and listener factory) and the publisher; both back off if the application defines its own.
  • BabelQueueProperties — babelqueue.default-queue.

Notes

  • Pre-1.0: the public API may change before the 1.0.0 tag.
  • Built on the framework-agnostic com.babelqueue:babelqueue-core; targets Spring Boot 3 and Java 17+.