feat!: (regen) breaking flux timestamps req-double + close-stream/hints; diarize_model, profanity

[GregHolmes]

SDK Regeneration — 2026-06-15

Generated from deepgram-docs branch devin/1781285195-flux-word-timestamps. The Java SDK was last regenerated 2026-05-15 (0.5.0), so this also catches up on doc changes merged since then.

⚠️ Breaking changes

1. ListenV2CloseStream — type removed; ListenV2CloseStreamType deleted. getType() is now a fixed "CloseStream" constant and the builder no longer accepts .type(...). Migration: ListenV2CloseStream.builder().build(). (docs #946)
2. DeepgramListenProviderV2 — language_hint → language_hints. getLanguageHint() → getLanguageHints(); type Optional<DeepgramListenProviderV2LanguageHint> → Optional<List<String>> (now multi-value); DeepgramListenProviderV2LanguageHint deleted. (docs #856)

On-the-wire payloads are unchanged — these are source/compile-time breaks for SDK users, not protocol breaks.

No compatibility shims. Unlike the Python SDK (which keeps ListenV2CloseStreamType / DeepgramListenProviderV2LanguageHint as frozen shims), the Java SDK takes the clean break: it is pre-1.0, so source-breaking changes ship in the 0.6.0 minor bump. Users update call sites once; no hand-maintained shim files or extra .fernignore freezes are carried.

Additive

• Flux word timestamps — ListenV2TurnInfoWordsItem gains start/end as Optional<Double> (getStart()/getEnd() return Optional<Double>; builder accepts Double or Optional<Double>, defaulting to empty). This is the primary change the source branch was for. (generation branch; latest regen made these optional rather than required) Note: although the field is additive on the wire, the getter return-type change (double → Optional<Double>) is source-breaking for existing call sites.
• DiarizeModel (v1/latest), diarize_model on streaming requests; diarize deprecated. (docs #943)
• ListenV2ProfanityFilter + profanity_filter query param. (docs #912)
• V1ConnectOptions / V2ConnectOptions extended — these types already existed on main; this regen adds fields, it does not introduce the types.

Generator plumbing (Fern CLI 5.44.6, docs #940)

• DateTimeDeserializer now falls back to space-separated timestamps (e.g. "2025-02-15 10:30:00+00:00").
• WebSocket clients use the headers((RequestOptions) null) overload.
• A batch of *ListRequest / *GetRequest query-param request types changed @JsonIgnore → @JsonProperty("…") on their fields — a real serialization-annotation change, not whitespace. These objects build query strings rather than JSON bodies, so request behavior is unchanged, but the annotations now match the wire field names.

Manual patches reconciled

• core/ClientOptions.java — generator reverted to wrong SDK coordinates (com.deepgram.fern:api-sdk / com.deepgram:deepgram-sdk) and hardcoded 0.5.1, stripping the release-please markers. Restored com.deepgram:deepgram-java-sdk headers + // x-release-please-version markers at 0.5.0 (the repo's real version per build.gradle/pom.xml/tag v0.5.0; release-please owns the bump).
• core/ReconnectingWebSocketListener.java — restored in full: maxRetries(0) "connect once, don't retry" (retryCount > maxRetries), configurable connectionTimeoutMs (was hardcoded 4000ms), and the applyOptionsOverride(...) hook used by TransportWebSocketFactory.
• resources/listen/v2/types/ListenV2CloseStream.java — added a hashCode() consistent with the generated constant equals() (Fern emits equals() but no hashCode(), an Object-contract violation). Newly frozen in .fernignore pending an upstream Fern fix.
• .fernignore — ClientOptions and ReconnectingWebSocketListener paths restored to originals; ListenV2CloseStream added; no entries dropped.
• examples/listen/LiveStreamingV2.java — updated to the new close-stream API (dropped ListenV2CloseStreamType import + .type(...) call). Caught by compileExamples.
• .bak files deleted.

Tests added

• RegenTypesTest covering this regen's type-shape changes: ListenV2TurnInfoWordsItem start/end optional round-trip (present and absent), ListenV2CloseStream fixed "CloseStream" type + equals/hashCode contract, and DeepgramListenProviderV2 language_hints list round-trip.

Verification

./gradlew test compileExamples — BUILD SUCCESSFUL (unit/wire tests incl. the new RegenTypesTest, README snippets, and hand-maintained examples all compile).

Release

Pre-1.0, so source-breaking changes ship in a 0.6.0 minor bump via the feat! title; release-please cuts the version and owns the CHANGELOG in its own PR. Source breaks to enumerate in that changelog:

• ListenV2CloseStream.type removed / ListenV2CloseStreamType deleted — use ListenV2CloseStream.builder().build().
• DeepgramListenProviderV2: language_hint → language_hints (getLanguageHint() → getLanguageHints(), now Optional<List<String>>); DeepgramListenProviderV2LanguageHint deleted.
• ListenV2TurnInfoWordsItem.getStart() / getEnd() return type double → Optional<Double> (source-breaking for existing call sites, though additive on the wire).

[dg-coreylweathers]

Reviewed: CI green across Java 11/17/21, all audit follow-ups resolved (start/end now Optional, ListenV2CloseStream hashCode added + frozen, RegenTypesTest added, description corrected). Clean-break (no compat shims) ratified — pre-1.0, breaks enumerated in the feat! title. Approving for squash-merge.