Skip to content

Regenerate SDK: Moderation API + grouped request parameters#5

Merged
winrid merged 10 commits into
mainfrom
regen-moderation-api
Jun 30, 2026
Merged

Regenerate SDK: Moderation API + grouped request parameters#5
winrid merged 10 commits into
mainfrom
regen-moderation-api

Conversation

@winrid

@winrid winrid commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

Regenerates the Swift client from the latest OpenAPI spec. Two notable changes since the last release:

Grouped request parameters: all API methods now take required parameters and the request body positionally, with an operation's optional parameters that are grouped into a single options struct, e.g. CreateCommentPublicOptions (a lone optional is a direct argument, and operations with none take none).

Moderation API: adds the moderator-dashboard endpoints (listing, searching, counting and exporting comments and logs; moderation actions such as remove/restore/flag and review/spam/approval status; vote adjustments; bans; badges and trust), authenticated with an SSO moderator token.

Model rename: PostRemoveCommentResponse is renamed to PostRemoveCommentApiResponse.

winrid added 8 commits June 22, 2026 14:09
…astId params)

Adds the optional tenantId query param to the SSO-gated Moderation API endpoints
and the optional broadcastId query param to the mutating moderation endpoints.
Backward-compatible. Mirrors fastcomments-sdk-js v5.0.2.
The regen overwrote the deliberate customization in URLSessionImplementations.swift
(ephemeral URLSession config with cookies disabled), which prevents the server from
tying userIdWS to a session cookie -- stale/shared cookies otherwise return the wrong
userIdWS and break presence p-u events. update.sh's 'rm -rf ./client' deletes both
.openapi-generator-ignore and the patched file before generation, so the ignore never
engaged. Re-apply the patch, restore the ignore entry, and have update.sh restore the
protected files from git after generation so every future regen keeps them.
API methods now take a single Api<Op>Request struct. Updated SSO integration tests and README examples.
API reference examples now construct the single Api<Op>Request object, matching the grouped method signatures.
API methods now take required params + body positionally, with optional params in a single Api<Op>Options struct. Updated SSO tests + README.
…one value)

Operations with exactly one optional now take it directly (e.g. deleteModerator(..., send_email)); the Api<Op>Options object is only used for 2+ optionals.
…p Api prefix from options types

Options types renamed Api<Op>Options -> <Op>Options (e.g. ApiGetApiCommentsOptions -> GetApiCommentsOptions). Hand-written READMEs + SSO tests updated to match.
@winrid winrid changed the title Regenerate SDK: moderation tenantId + broadcastId params Regenerate SDK: Moderation API + grouped request parameters Jun 30, 2026
winrid added 2 commits June 30, 2026 10:39
Replace the long capability enumeration with a concise summary.
Bump version to 3.0.0 and regenerate from the new generator fork release.
@winrid
winrid merged commit 7f297de into main Jun 30, 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