[CHA-1578] refactor: code generated from openapi specs

.github/workflows/prerelease.yml

@@ -0,0 +1,52 @@
+name: Pre-release
+
+on:
+  release:
+    types: [prereleased]
+
+jobs:
+  Prerelease:
+    name: 🚀 Pre-release
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Resolve version
+        run: |
+          TAG="${{ github.event.release.tag_name }}"
+          if [ -n "$TAG" ]; then
+            echo "VERSION=$TAG" >> $GITHUB_ENV
+          else
+            PROP=$(grep '^version=' gradle.properties | cut -d'=' -f2)
+            if [ -n "$PROP" ]; then
+              echo "VERSION=$PROP" >> $GITHUB_ENV
+            else
+              echo "❌ Could not determine version from tag or gradle.properties" && exit 1
+            fi
+          fi
+
+      - name: Setup JDK 17
+        uses: actions/setup-java@v5.1.0
+        with:
+          distribution: 'corretto'
+          java-version: '17'
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Publish to MavenCentral
+        run: |
+          ./gradlew -Pversion=$VERSION publishToSonatype --no-daemon --max-workers 1 closeAndReleaseSonatypeStagingRepository
+        env:
+          STREAM_API_KEY: ${{ vars.STREAM_API_KEY }}
+          STREAM_API_SECRET: ${{ secrets.STREAM_API_SECRET }}
+          GPG_KEY_CONTENTS: ${{ secrets.GPG_KEY_CONTENTS }}
+          OSSRH_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          OSSRH_PASSWORD: ${{ secrets.OSSRH_PASSWORD }}
+          SIGNING_KEY_ID: ${{ secrets.SIGNING_KEY_ID }}
+          SIGNING_PASSWORD: ${{ secrets.SIGNING_PASSWORD }}
+          SIGNING_SECRET_KEY_RING_FILE: ${{ secrets.SIGNING_SECRET_KEY_RING_FILE }}
+          SONATYPE_STAGING_PROFILE_ID: ${{ secrets.SONATYPE_STAGING_PROFILE_ID }}
+

.github/workflows/release.yml

@@ -21,7 +21,7 @@ jobs:
           script: |
             // Getting the release version from the PR source branch
             // Source branch looks like this: release-1.0.0
-            const version = context.payload.pull_request.head.ref.split('-')[1]
+            const version = context.payload.pull_request.head.ref.replace(/^release-/, '')
             core.exportVariable('VERSION', version)
 
       - name: Setup JDK 17

CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [6.0.0-beta.1](https://github.com/GetStream/stream-sdk-java/compare/5.0.1...6.0.0-beta.1) (2026-02-27)
+
+### 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_v5_to_v6.md](./MIGRATION_v5_to_v6.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.
+- `Pager` renamed to `PagerResponse` and migrated from offset-based to cursor-based pagination (`next`/`prev` tokens).
+
+### 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 class for receiving webhook payloads, utility methods for decoding and verifying webhook signatures, and a full set of individual typed event classes for every event across all products (Chat, Video, Moderation, Feeds) usable as discriminated event types.
+- Cursor-based pagination across all list endpoints.
+
 ### [5.0.1](https://github.com/GetStream/stream-sdk-java/compare/5.0.0...5.0.1) (2026-02-11)
 
 ## [5.0.0](https://github.com/GetStream/stream-sdk-java/compare/4.1.1...5.0.0) (2026-02-03)

CONTRIBUTING.md

@@ -120,3 +120,7 @@ The job creates a pull request with the changelog. Check if it looks good.
 - Merge the pull request.
 
 Once the PR is merged, it automatically kicks off another job which will upload the Gem to RubyGems.org and creates a GitHub release.
+
+### Pre-releases
+
+Push a tag (e.g. `1.0.0-beta.1`), then go to **GitHub Releases → Draft a new release**, select the tag, check **"Set as a pre-release"**, and publish. The CI job will trigger automatically and publish to MavenCentral.

MIGRATION_v5_to_v6.md

@@ -0,0 +1,213 @@
+# Migration Guide: v5 → v6
+
+This guide covers all breaking changes when upgrading from `stream-sdk-java` v5 to v6.
+
+## Overview
+
+v6 is a full OpenAPI-aligned release. The primary change is a **systematic type renaming**: types that appear in API responses now have a `Response` suffix, and input types have a `Request` suffix. There are no removed features — all functionality from v5 is available in v6. Additionally, v6 adds complete coverage of the **Feeds**, **Video**, and **Moderation** product APIs.
+
+## Installation
+
+Update your Maven `pom.xml`:
+
+```xml
+<dependency>
+    <groupId>io.getstream</groupId>
+    <artifactId>stream-sdk-java</artifactId>
+    <version>6.0.0</version>
+</dependency>
+```
+
+Or your Gradle `build.gradle`:
+
+```groovy
+implementation 'io.getstream:stream-sdk-java:6.0.0'
+```
+
+## Naming Conventions
+
+All types use `PascalCase` and fields use `camelCase` (standard Java convention). The general rules:
+
+- Types returned in API responses: `Foo` → `FooResponse`
+- Types used as API inputs: `Foo` → `FooRequest`
+- Some moderation action payloads: `FooRequest` → `FooRequestPayload`
+
+## Breaking Changes
+
+### Common / Shared Types
+
+| v5 | v6 | Notes |
+| --- | --- | --- |
+| `ApplicationConfig` | `AppResponseFields` | App configuration in responses |
+| `ChannelPushPreferences` | `ChannelPushPreferencesResponse` | Per-channel push settings |
+| `Device` | `DeviceResponse` | Device data (push, voip) |
+| `Event` | `WSEvent` | WebSocket event envelope |
+| `FeedsPreferences` | `FeedsPreferencesResponse` | Feeds push preferences |
+| `ImportV2Task` | `ImportV2TaskItem` | V2 import task |
+| `OwnUser` | `OwnUserResponse` | Authenticated user data |
+| `Pager` | `PagerResponse` | Now cursor-based (`next`/`prev`) |
+| `PushPreferences` | `PushPreferencesResponse` | Push preferences |
+| `PushTemplate` | `PushTemplateResponse` | Push template |
+| `PrivacySettings` | `PrivacySettingsResponse` | Typing indicators, read receipts |
+| `RateLimitInfo` | `LimitInfoResponse` | Rate limit info |
+| `SortParam` | `SortParamRequest` | Sort parameter for queries |
+| `User` | `UserResponse` | Full user in responses |
+| `UserBlock` | `BlockedUserResponse` | Blocked user details |
+| `UserCustomEvent` | `CustomEvent` | Custom user event |
+| `UserMute` | `UserMuteResponse` | User mute details |
+
+### Event System
+
+| Before (v5) | After (v6) | Notes |
+| --- | --- | --- |
+| `BaseEvent` (field `T`) | `Event` (field `type`) | Base event type |
+| `Event` (WS envelope) | `WSEvent` | WebSocket event wrapper |
+| `*Preset` embeds | `Has*` composition types | e.g., `HasChannel`, `HasMessage` |
+| — | `WHEvent` | New webhook envelope type |
+
+New composition types: `HasOwnUser`, `HasUserCommonFields`, `HasUserPrivacyFields`, `HasOptionalUserCommonFields`, `HasChannel`, `HasOptionalChannel`, `HasMessage`, `HasOptionalMessage`, `HasThreadParticipants`, `HasChannelTypeAndID`.
+
+### Chat Types
+
+| v5 | v6 | Notes |
+| --- | --- | --- |
+| `Campaign` | `CampaignResponse` | |
+| `CampaignStats` | `CampaignStatsResponse` | |
+| `Channel` | `ChannelResponse` | |
+| `ChannelConfigFields` | `ChannelConfigWithInfo` | Channel config + commands/grants |
+| `ChannelMember` | `ChannelMemberResponse` | |
+| `ChannelTypeConfigWithInfo` | `ChannelTypeConfig` | |
+| `ConfigOverrides` | `ConfigOverridesRequest` | |
+| `DraftMessage` / `DraftMessagePayload` | `DraftResponse` | Two types merged into one |
+| `Message` | `MessageResponse` | |
+| `MessageReminder` | `ReminderResponseData` | |
+| `PendingMessage` | `PendingMessageResponse` | |
+| `Poll` | `PollResponse` | |
+| `PollOption` | `PollOptionResponse` | |
+| `PollVote` | `PollVoteResponse` | |
+| `Reaction` | `ReactionResponse` | |
+| `ReadState` | `ReadStateResponse` | |
+| `Thread` | `ThreadResponse` | |
+
+### Video Types
+
+| v5 | v6 | Notes |
+| --- | --- | --- |
+| `AudioSettings` | `AudioSettingsResponse` | |
+| `BackstageSettings` | `BackstageSettingsResponse` | |
+| `BroadcastSettings` | `BroadcastSettingsResponse` | |
+| `Call` | `CallResponse` | |
+| `CallEgress` | `EgressResponse` | |
+| `CallMember` | `MemberResponse` | Note: not `CallMemberResponse` |
+| `CallParticipant` | `CallParticipantResponse` | |
+| `CallParticipantFeedback` | *(removed)* | Use `CollectUserFeedbackRequest` |
+| `CallSession` | `CallSessionResponse` | |
+| `CallSettings` | `CallSettingsResponse` | |
+| `CallType` | `CallTypeResponse` | |
+| `EventNotificationSettings` | `EventNotificationSettingsResponse` | |
+| `FrameRecordSettings` | `FrameRecordingSettingsResponse` | `Recording` inserted in name |
+| `GeofenceSettings` | `GeofenceSettingsResponse` | |
+| `HLSSettings` | `HLSSettingsResponse` | |
+| `IndividualRecordSettings` | `IndividualRecordingSettingsResponse` | `Recording` inserted in name |
+| `IngressSettings` | `IngressSettingsResponse` | |
+| `IngressSource` | `IngressSourceResponse` | |
+| `IngressAudioEncodingOptions` | `IngressAudioEncodingResponse` | Shortened name |
+| `IngressVideoEncodingOptions` | `IngressVideoEncodingResponse` | Shortened name |
+| `IngressVideoLayer` | `IngressVideoLayerResponse` | |
+| `LimitsSettings` | `LimitsSettingsResponse` | |
+| `NotificationSettings` | `NotificationSettingsResponse` | |
+| `RawRecordSettings` | `RawRecordingSettingsResponse` | `Recording` inserted in name |
+| `RecordSettings` | `RecordSettingsResponse` | |
+| `RingSettings` | `RingSettingsResponse` | |
+| `RTMPSettings` | `RTMPSettingsResponse` | |
+| `ScreensharingSettings` | `ScreensharingSettingsResponse` | |
+| `SessionSettings` | `SessionSettingsResponse` | |
+| `SIPCallConfigs` | `SIPCallConfigsResponse` | |
+| `SIPCallerConfigs` | `SIPCallerConfigsResponse` | |
+| `SIPDirectRoutingRuleCallConfigs` | `SIPDirectRoutingRuleCallConfigsResponse` | |
+| `SIPInboundRoutingRules` | `SIPInboundRoutingRuleResponse` | Plural → singular |
+| `SIPPinProtectionConfigs` | `SIPPinProtectionConfigsResponse` | |
+| `SIPTrunk` | `SIPTrunkResponse` | |
+| `ThumbnailsSettings` | `ThumbnailsSettingsResponse` | |
+| `TranscriptionSettings` | `TranscriptionSettingsResponse` | |
+| `VideoSettings` | `VideoSettingsResponse` | |
+
+### Moderation Types
+
+| v5 | v6 | Notes |
+| --- | --- | --- |
+| `ActionLog` | `ActionLogResponse` | |
+| `Appeal` | `AppealItemResponse` | |
+| `AutomodDetails` | `AutomodDetailsResponse` | |
+| `Ban` | `BanInfoResponse` | |
+| `BanOptions` | *(removed)* | Merged into `BanActionRequestPayload` |
+| `BanActionRequest` | `BanActionRequestPayload` | |
+| `BlockActionRequest` | `BlockActionRequestPayload` | |
+| `BlockedMessage` | *(removed)* | Internal only |
+| `CustomActionRequest` | `CustomActionRequestPayload` | |
+| `DeleteMessageRequest` | `DeleteMessageRequestPayload` | |
+| `DeleteUserRequest` | `DeleteUserRequestPayload` | |
+| `EntityCreator` | `EntityCreatorResponse` | |
+| `Evaluation` | `EvaluationResponse` | |
+| `FeedsModerationTemplate` | `QueryFeedModerationTemplate` | No `Response` suffix |
+| `FeedsModerationTemplateConfig` | `FeedsModerationTemplateConfigPayload` | |
+| `Flag` | *(removed)* | Use `ModerationFlagResponse` |
+| `Flag2` | `ModerationFlagResponse` | |
+| `FlagDetails` | `FlagDetailsResponse` | |
+| `FlagFeedback` | `FlagFeedbackResponse` | |
+| `FlagMessageDetails` | `FlagMessageDetailsResponse` | |
+| `FlagReport` | *(removed)* | Internal only |
+| `FutureChannelBan` | `FutureChannelBanResponse` | |
+| `MarkReviewedRequest` | `MarkReviewedRequestPayload` | |
+| `Match` | `MatchResponse` | |
+| `ModerationActionConfig` | `ModerationActionConfigResponse` | |
+| `ModerationBulkSubmitActionRequest` | `BulkSubmitActionRequest` | `Moderation` prefix dropped |
+| `ModerationConfig` | `ConfigResponse` | |
+| `ModerationFlags` | *(removed)* | Use `List<ModerationFlagResponse>` |
+| `ModerationLog` | *(removed)* | Use `ActionLogResponse` |
+| `ModerationLogResponse` | *(removed)* | Use `QueryModerationLogsResponse` |
+| `ModerationUsageStats` | `ModerationUsageStatsResponse` | |
+| `RestoreActionRequest` | `RestoreActionRequestPayload` | |
+| `ReviewQueueItem` | `ReviewQueueItemResponse` | |
+| `Rule` | `RuleResponse` | |
+| `ShadowBlockActionRequest` | `ShadowBlockActionRequestPayload` | |
+| `Task` | `TaskResponse` | |
+| `Trigger` | `TriggerResponse` | |
+| `UnbanActionRequest` | `UnbanActionRequestPayload` | |
+| `UnblockActionRequest` | `UnblockActionRequestPayload` | |
+| `VideoEndCallRequest` | `VideoEndCallRequestPayload` | |
+| `VideoKickUserRequest` | `VideoKickUserRequestPayload` | |
+
+### Feeds Types
+
+| v5 | v6 | Notes |
+| --- | --- | --- |
+| `Activity` | `ActivityResponse` | |
+| `ActivityFeedback` | `ActivityFeedbackRequest` | Request-only (no `Response` suffix) |
+| `ActivityMark` | `MarkActivityRequest` | |
+| `ActivityPin` | `ActivityPinResponse` | |
+| `AggregatedActivity` | `AggregatedActivityResponse` | |
+| `Bookmark` | `BookmarkResponse` | |
+| `BookmarkFolder` | `BookmarkFolderResponse` | |
+| `Collection` | `CollectionResponse` | |
+| `Comment` | `CommentResponse` | |
+| `CommentMedia` | *(removed)* | Embedded inline in `CommentResponse` |
+| `CommentMention` | *(removed)* | Embedded inline in `CommentResponse` |
+| `DenormalizedFeedsReaction` | *(removed)* | Internal only |
+| `Feed` | `FeedResponse` | |
+| `FeedGroup` | `FeedGroupResponse` | |
+| `FeedMember` | `FeedMemberResponse` | |
+| `FeedsReaction` | `FeedsReactionResponse` | |
+| `FeedsReactionGroup` | `FeedsReactionGroupResponse` | |
+| `FeedSuggestion` | `FeedSuggestionResponse` | |
+| `FeedView` | `FeedViewResponse` | |
+| `FeedVisibilityInfo` | `FeedVisibilityResponse` | |
+| `Follow` | `FollowResponse` | |
+| `MembershipLevel` | `MembershipLevelResponse` | |
+| `ThreadedComment` | `ThreadedCommentResponse` | |
+
+## Getting Help
+
+- [Stream documentation](https://getstream.io/docs/)
+- [GitHub Issues](https://github.com/GetStream/stream-sdk-java/issues)
+- [Stream support](https://getstream.io/contact/support/)

README.md

@@ -90,6 +90,9 @@ call.getOrCreate(
         .build());
 ```
 
+> **Note:** When constructing models, always use the **builder pattern** (e.g. `UserRequest.builder().id("id").build()`).
+> While some generated models expose positional constructors (for example via Lombok's `@AllArgsConstructor`), their parameter order is not part of the public API and may change between releases; using positional constructors is therefore strongly discouraged and may break across SDK updates.
+
 ## Development
 
 To run tests, create the `local.properties` file using the `local.properties.example` and adjust it to have valid API credentials:

generate.sh

@@ -11,11 +11,13 @@ fi
 set -ex
 
 # cd in API repo, generate new spec and then generate code from it
-( cd $SOURCE_PATH ; make openapi ; go run ./cmd/chat-manager openapi generate-client --language java --spec ./releases/v2/serverside-api.yaml --output ../stream-sdk-java/src/main/java/io/getstream )
+( cd $SOURCE_PATH ; make openapi ; go run ./cmd/chat-manager openapi generate-client --language java --spec ./releases/v2/serverside-api.yaml --output ../stream-sdk-java )
 
-sed -i '' '/^    @JsonProperty("Role")$/N;/\n    private String role;$/d' src/main/java/io/getstream/models/CallParticipant.java
+perl -i -0pe 's/    \@JsonProperty\("Role"\)\n    private String role;\n//g' src/main/java/io/getstream/models/CallParticipant.java
 
-# format generated code
-./gradlew spotlessApply
+# Clean up test files that may exist in main source from older generator versions
+# (generator now outputs tests directly to src/test/)
+rm -f src/main/java/io/getstream/WebhookTest.java
 
-./gradlew build -x test
+# format generated code, clean stale Gradle/Spotless caches, then build
+./gradlew clean spotlessApply build -x test

gradle.properties

@@ -1 +1 @@
-version=5.0.1
+version=6.0.0-beta.1