Skip to content

docs: cover the moderation tail in the stream-chat-go migration guide - #136

Merged
mogita merged 1 commit into
mainfrom
docs/moderation-tail-migration
Aug 1, 2026
Merged

docs: cover the moderation tail in the stream-chat-go migration guide#136
mogita merged 1 commit into
mainfrom
docs/moderation-tail-migration

Conversation

@mogita

@mogita mogita commented Aug 1, 2026

Copy link
Copy Markdown
Contributor

Adds the moderation operations the migration guide did not document yet, so a Chat + Moderation integration has a documented path rather than a gap: user blocking, blocklists, flagging, and reviewing flagged content.

Worth a look during review

Blocklist is spelled BlockList in this SDK. Every method renames with it (CreateBlocklist to CreateBlockList, ListBlocklists to ListBlockLists). Easy to miss, and it makes the migration look like a missing feature when it is really a rename.

Flags cross a v1/v2 boundary. The legacy FlagMessage / FlagUser write to the v1 chat flags store, while this SDK exposes v2 moderation via Moderation().Flag(). As the note in chat_misc_integration_test.go already says, QueryMessageFlags (v1) may not see flags created through v2. Swapping the call alone can leave a workflow writing to one store and reading from another, so the guide now warns and tells the reader to migrate flag/query/review together.

Flag reports are a redesign, not a rename. QueryFlagReports and ReviewFlagReport have no drop-in replacement; they map onto the v2 review queue (QueryReviewQueue, GetReviewQueueItem, SubmitAction). Documented as rework rather than a call swap.

Verification

Every before and after snippet in the new sections was compiled: the before code against stream-chat-go v8 and the after code against getstream-go v5. That caught two real errors before commit (SubmitActionRequest.ItemID is a *string, and BlocklistCreateRequest embeds BlocklistBase).

Context: this guide is the source of truth for the SDK migration skill being built in GetStream/agent-skills, so gaps here become gaps a customer hits.

Adds the moderation operations the guide did not document yet: user
blocking, blocklists, flagging, and reviewing flagged content.

Two things worth calling out for anyone migrating:

- Blocklist types are spelled BlockList in the new SDK, so every method
  renames (CreateBlocklist to CreateBlockList, ListBlocklists to
  ListBlockLists, and so on).
- The legacy flag methods write to the v1 chat flags store while this SDK
  exposes v2 moderation, so flagging and querying can end up on opposite
  sides of that boundary. The guide now warns about it, and documents the
  v1 flag-report workflow as a redesign onto the v2 review queue rather
  than a rename.

All before and after snippets were compiled against stream-chat-go v8 and
getstream-go v5 respectively.
@mogita
mogita requested a review from tbarbugli as a code owner August 1, 2026 10:42
@mogita
mogita temporarily deployed to feeds-enabled-shard August 1, 2026 10:42 — with GitHub Actions Inactive
@mogita
mogita temporarily deployed to feeds-enabled-shard August 1, 2026 10:42 — with GitHub Actions Inactive
@mogita
mogita temporarily deployed to feeds-enabled-shard August 1, 2026 10:42 — with GitHub Actions Inactive
@mogita
mogita temporarily deployed to feeds-enabled-shard August 1, 2026 10:42 — with GitHub Actions Inactive
@mogita
mogita temporarily deployed to feeds-enabled-shard August 1, 2026 10:42 — with GitHub Actions Inactive
@mogita
mogita temporarily deployed to feeds-enabled-shard August 1, 2026 10:42 — with GitHub Actions Inactive
@mogita
mogita merged commit df4fbd1 into main Aug 1, 2026
11 checks passed
@mogita
mogita deleted the docs/moderation-tail-migration branch August 1, 2026 11:16
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