Skip to content

Add Moderation API and stable response types#1

Merged
winrid merged 6 commits into
mainfrom
regen-moderation-api
Jun 19, 2026
Merged

Add Moderation API and stable response types#1
winrid merged 6 commits into
mainfrom
regen-moderation-api

Conversation

@winrid

@winrid winrid commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Moderation API

Adds a Moderation API with methods for the moderator dashboard:

  • Comments — list, count, fetch by id(s) and children, get/set comment text, logs, export, search (users / pages / sites / comments), suggestions
  • Moderation actions — remove / restore, flag / un-flag, set review / spam / approval status, adjust / cast / delete votes, reopen / close thread
  • Bans — ban from comment, undo ban, pre-ban and bulk pre-ban summaries, comment ban status, ban preferences, banned-user counts and lookup
  • Badges & trust — award / remove badge, manual badges, get / set trust factor, user internal profile

All Moderation methods accept an sso parameter for SSO-authenticated moderators.

Response types (breaking)

Each method now returns its success response type directly, with errors surfaced as a default error response, instead of the previous combined success-or-error return type. The response type names are now stable. Response shapes are unchanged.

Recommend a major version bump.

Regenerated the Dart client from the updated OpenAPI spec
(mirrors fastcomments-sdk@4.0.0).

- Adds Moderation API (43 moderator-dashboard endpoints) as a
  separate ModerationApi class (lib/api/moderation_api.dart). All
  endpoints accept an 'sso' query param. Covers comment moderation,
  bans, badges & trust factor, and search.
- BREAKING: operations now return their success type directly
  instead of an 'X | APIError' union; APIError is a 'default' error
  response. Response shapes are unchanged. The old generated
  '*200Response' wrapper types are removed in favor of the real
  success types.
@winrid winrid changed the title Regenerate SDK: add Moderation API + stable response types Add Moderation API and stable response types Jun 19, 2026
winrid added 5 commits June 18, 2026 22:19
Fixes anyOf empty-class syntax and nested-map deserialization that the
released generator produces incorrectly. update.py now downloads the
generator jar instead of using the npm wrapper.
The client package only has generated model tests; add a small sso_tests package
that depends on the client + crypto and exercises the hand-written sso/ helpers:
SSO token generation (unit) and live create+fetch via secure SSO (integration).
@winrid
winrid merged commit 13c9d32 into main Jun 19, 2026
1 check passed
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