Release v4.2.0

[github-actions]

🚀 v4.2.0

Make sure to use squash & merge when merging!
Once this is merged, another job will kick off automatically and publish the package.

📝 Changelog

Changelog

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

4.2.0 (2026-06-16)

Features

• add segment management methods to ChatClient (#114) (566815e)

4.1.2 (2026-06-15)

Features

• [CHA-2958] standardize error handling (#112) (fcd20e7)

4.2.0 (2026-MM-DD)

Features

• Added segment management methods to ChatClient: CreateSegment, UpdateSegment, and AddSegmentTargets. Segments targeted by a campaign can now be created and edited through the SDK, completing the campaign workflow without falling back to raw REST (CHA-3483).

• Standardized error handling per the Server-Side SDK Error Handling Spec (CHA-2958).

  • Four sentinel error categories on the existing *StreamError: ErrApiResponse, ErrRateLimited, ErrTransport, ErrTaskFailed. Use errors.Is(err, ...) to branch and errors.As(err, &streamErr) to extract typed fields. ErrRateLimited also satisfies errors.Is(err, ErrApiResponse).
  • New fields on StreamError: Unrecoverable, Details, RawResponseBody, RetryAfter, ErrorType, Task. No existing field accesses change.
  • Transport-layer failures (connection reset / refused, timeout, DNS, TLS, broken pipe) are now wrapped at the HTTP-client boundary into *StreamError with ErrTransport; the original error is preserved via errors.Unwrap. ErrorType is one of connection_reset, timeout, dns_failure, tls_handshake_failed, unknown (matches the logging spec error.type enum).
  • Retry-After response header is parsed on HTTP 429 (both RFC 7231 §7.1.3 integer-seconds and HTTP-date forms) and exposed as StreamError.RetryAfter. Auto-retry is not part of this SDK; callers compose their own retry strategy using RetryAfter and Unrecoverable.
  • Unparseable error bodies (HTTP response received but JSON envelope malformed or absent) surface as ErrApiResponse with code=0, Message="failed to parse error response", and the raw body preserved on RawResponseBody. The JSON parse error is reachable via the cause chain.
  • New public helper WaitForTask(ctx, client, taskID, opts...) polls the task-status endpoint until terminal state. On status="failed" returns *StreamError with ErrTaskFailed and Task populated from the backend's ErrorResult. On timeout / context cancellation returns *StreamError with ErrTransport and ErrorType="timeout". Defaults: 1s poll interval, 60s wait timeout — override with WithWaitForTaskPollInterval / WithWaitForTaskTimeout.
  • Internal stack.Wrap helper (~30 lines, runtime.Caller-based, no external dependency) replaces fmt.Errorf("...: %w", err) in every user-facing path. fmt.Sprintf("%+v", err) now prints the captured wrap site for any error produced by the SDK.

• Explicit HTTP connection pool configuration (CHA-2956).
  Four new functional options:

  • WithMaxConnsPerHost(int): default 5
  • WithIdleTimeout(time.Duration): default 55s
  • WithConnectTimeout(time.Duration): default 10s
  • WithRequestTimeout(time.Duration): default 30s (was 6s; see Behavior changes)
    These tune the underlying *http.Transport. WithHTTPClient continues to act as an escape hatch; when set, none of the four new options apply.

• INFO log on client construction lists the effective pool config.

Behavior changes

• Default RequestTimeout is now 30s (was 6s). Aligns the Go SDK with the cross-SDK contract in CHA-2956. Existing callers using WithTimeout(...) are unaffected. Callers relying on the 6s ceiling for fail-fast behavior should pass WithRequestTimeout(6 * time.Second) (or WithTimeout(...), kept as an alias for backward compatibility).
• Default HTTP transport now caps connections per host at 5 and closes idle sockets after 55s (vs. unlimited / unbounded previously). Behavior matches legacy stream-chat-go (5 / 59s) modulo the 4s tighter idle window.

4.1.1 (2026-05-21)

4.1.0 (2026-05-01)

4.0.6 (2026-04-23)

Features

• add bookmark for comments (#97) (7e41662)
• regenerate from latest OpenAPI spec, keep only retention runs test (5d543c4)
• update opnepai specs (3f28e35)

Bug Fixes

• skip retention tests when endpoints unavailable (404) (faff5e6)

4.0.4 (2026-03-31)

4.0.3 (2026-03-23)

4.0.2 (2026-03-19)

Bug Fixes

• add omitempty on pointer types (#87) (e98f4c9)

4.0.1 (2026-03-19)

4.0.0 (2026-03-05)

Breaking Changes

• Type names across all products now follow the OpenAPI spec naming convention: response types are suffixed with Response, input types with Request. See MIGRATION_v3_to_v4.md for the complete rename mapping.
• Event (WebSocket envelope type) renamed to WSEvent. Base event type renamed from BaseEvent to Event (with field type instead of T).
• Event composition changed from monolithic *Preset embeds to modular Has* types (HasChannel, HasMessage, HasUserCommonFields, etc.).
• Pager renamed to PagerResponse and migrated from offset-based to cursor-based pagination (next/prev tokens).
• Module path changed from github.com/GetStream/getstream-go/v4 to github.com/GetStream/getstream-go/v4.

Added

• Full product coverage: Chat, Video, Moderation, and Feeds APIs are all supported in a single SDK.
• Feeds: activities, feeds, feed groups, follows, comments, reactions, collections, bookmarks, membership levels, feed views, and more.
• Video: calls, recordings, transcription, closed captions, SFU, call statistics, user feedback analytics, and more.
• Moderation: flags, review queue, moderation rules, config, appeals, moderation logs, and more.
• Push notification types, preferences, and templates.
• Webhook support: WHEvent envelope type for receiving webhook payloads, utility functions for decoding and verifying webhook signatures, and a full set of individual typed event structs for every event across all products (Chat, Video, Moderation, Feeds) usable as discriminated event types.
• Cursor-based pagination across all list endpoints.

3.8.0 (2026-02-03)

3.7.0 (2025-11-28)

3.6.0 (2025-11-18)

3.5.0 (2025-11-13)

3.4.0 (2025-11-12)

3.3.0 (2025-10-10)

3.2.0 (2025-09-30)

3.1.2 (2025-09-19)

3.1.1 (2025-09-02)

Features

• add SendClosedCaption + other updates (#45) (21e8050)

3.1.0-feeds (2025-08-25)

3.0.0-feeds (2025-08-13)

3.0.1-feeds (2025-08-13)

3.0.0-feeds (2025-08-05)

2.1.0 (2025-05-06)

2.0.0 (2025-04-30)

1.2.0 (2025-02-10)

1.2.0 (2025-02-10)

1.1.0 (2025-01-13)

1.0.0 (2024-12-31)

0.0.1: Initial release of the package (2024-10-28)