Repository navigation
1.2.0: destination secrets, bridge destinations, holds, replay edits, transform engines - #3
Merged
Merged
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.signingSecreton create,hasSigningSecret,revealSecret,rotateSecret(id, gracePeriodSeconds).BridgeConfig,test(id, payload)dry run,OutboundMessageBridge.holdExpiresAt,holdOnCircuitOpen(falsedead-letters as soon as the circuit opens),heldCount/heldCountCapped,messagesHeld, statsheld, typed event-debug deliveries.catalogProvideron sources (create only).Fixes
Upgrade notes
See "Upgrading to 1.2" in the README: new record components on
Destination,Route,Endpoint,Delivery,OutboundMessage,SourceandSourceWithSecret(direct constructor calls and record patterns need them), andreplay(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.Release: GitHub Release
v1.2.0→ Maven Central (checkReleaseTag), after merge.🤖 Generated with Claude Code
https://claude.ai/code/session_01HjDaS7Ev5M2d6wEzizwLLS