Skip to content

1.2.0: destination secrets, bridge destinations, holds, replay edits, transform engines - #3

Merged
cade25wilson merged 6 commits into
masterfrom
feat/transform-languages
Nov 12, 2026
Merged

cade25wilson merged 6 commits into
masterfrom
feat/transform-languages

Conversation

@cade25wilson

@cade25wilson cade25wilson commented Oct 26, 2026 •

Copy link
Copy Markdown
Contributor

Brings the Java SDK up to the API as of 2026-11-12 and releases it as 1.2.0. This PR started as the transform-languages Javadoc change; the API-parity round is stacked on it.

New

  • transforms().engines(); deliveries().replay(id, ReplayDeliveryParams) with payload replace or merge patch and destination, transform and header overrides. A null argument leaves the field out.
  • Destination signing secrets: signingSecret on create, hasSigningSecret, revealSecret, rotateSecret(id, gracePeriodSeconds).
  • Bridge destinations: BridgeConfig, test(id, payload) dry run, OutboundMessageBridge.
  • Holds: holdExpiresAt, holdOnCircuitOpen (false dead-letters as soon as the circuit opens), heldCount/heldCountCapped, messagesHeld, stats held, typed event-debug deliveries.
  • catalogProvider on sources (create only).

Fixes

  • Source list fields were wrapped as a one-item list of the JSON string; API #131 sends arrays, which now read correctly (regression test added).

Upgrade notes

See "Upgrading to 1.2" in the README: new record components on Destination, Route, Endpoint, Delivery, OutboundMessage, Source and SourceWithSecret (direct constructor calls and record patterns need them), and replay(id, null) is now ambiguous.

Verification

  • ./gradlew build javadoc (warnings as errors): 507 tests.
  • scripts/test-all-sdks.sh --check java: interop matrix 414/414.
  • Integration harness against a local API at api origin/main: 176/176, none skipped.
  • Independent code review; findings fixed in 82d840a.

Release: GitHub Release v1.2.0 → Maven Central (checkReleaseTag), after merge.

🤖 Generated with Claude Code

https://claude.ai/code/session_01HjDaS7Ev5M2d6wEzizwLLS

transforms().engines() reads GET /api/transforms/engines: each transform language with its
label, file extension, starter code and whether it is available on the plan, plus the content
formats a transform can read and write.

deliveries().replay(id, ReplayDeliveryParams) sends the replay-with-edits fields: a full
modifiedPayload or a payloadPatch (JSON merge patch, RFC 7386), destinationOverride,
transformOverride (with persistTransform), and headersOverride. Setting both payload fields fails
before any request, as the API rejects it. replay(id) and replay(id, options) still send no body.
DeliveryReplayResult documents the flags the API returns.
Destination gains hasSigningSecret and signingSecret (set on an http destination's create
response only, redacted in toString). destinations().revealSecret() returns the secret and, during
a rotation's grace period, when the previous one stops being accepted;
destinations().rotateSecret() takes an optional gracePeriodSeconds and gives a destination created
before signing its first secret. A rotation is never retried.

Bridge destinations publish each delivery as an outbound event. BridgeConfig builds their config
(fixed event type or one read from a payload field, optional prefix, application and
allowUnverifiedSources); pass BridgeConfig.toMap() to config(). destinations().test(id, payload)
sends a sample payload: for a bridge this is a dry run, and DestinationTestResult gains dryRun,
eventType, eventTypeExists and matchingEndpoints (the old five-argument constructor stays).
OutboundMessage gains bridge: the inbound event and delivery a bridged message came from.
… event-debug deliveries

While a route's or endpoint's circuit is open, its deliveries and messages can wait as held
instead of spending attempts. Route and Endpoint gain holdOnCircuitOpen (on by default) and, on
get, heldCount and heldCountCapped; the create and update params gain holdOnCircuitOpen().
Delivery and OutboundMessage gain holdExpiresAt. SendMessageResponse gains messagesHeld (0 when
the API leaves it out) and MessageStatsSummary gains held; both keep their old constructors.
The delivery and message status docs now list every status the API returns.

EventDebugInfo.deliveryList() binds the debug deliveries to EventDebugDelivery records (retry,
hold, failure-cluster pattern hints and route circuit); deliveries() stays the raw JsonNode.
….2.0

Source, SourceWithSecret and CreateSourceParams gain catalogProvider: the provider-catalog entry a
source was created from. It is create-only, so SourceContractTest now expects create and update to
differ by slug, catalogProvider and isActive. A test pins that source list fields with several
entries bind as real lists.

README: version 1.2.0, a destinations and deliveries section (signing secrets, reveal and rotate,
bridge with a dry run, replay with edits) and a note on holds. Version 1.2.0.
…tter, upgrade notes

ReplayDeliveryParams: a null argument now leaves the field out (and drops an earlier value)
instead of sending JSON null. The API takes any field that is present as an edit, so
modifiedPayload(null) replayed a null body to the destination and the other setters got a 400.
extra(key, null) still sends a JSON null.

holdOnCircuitOpen docs: with holds off, a delivery or message is dead-lettered as soon as it
meets the open circuit, not retried as before. TransformEngine.fileExtension has no leading dot.

README: an "Upgrading to 1.2" section on the record components added, record deconstruction
patterns over the changed records, and the replay(id, null) ambiguity.
@cade25wilson cade25wilson changed the title Document new transform languages 1.2.0: destination secrets, bridge destinations, holds, replay edits, transform engines Nov 12, 2026
@cade25wilson
cade25wilson merged commit 3ac5eff into master Nov 12, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant