Regenerate SDK: Moderation API + grouped request parameters (#5)

* Regenerate SDK from latest OpenAPI spec (moderation tenantId + broadcastId 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.

* Regenerate against corrected spec (tsoa 6.6.8 splits X | APIError response unions)

* Bump version to 2.0.1 (patch over the 2.0.0 Moderation API release)

* Regenerate with grouped request objects; update.sh uses fork generator

API methods now take a single Api<Op>Request pydantic object (useSingleRequestParameter). update.sh now uses the FastComments openapi-generator fork, since the stock generator ignores the option for python. Updated SSO tests and README examples.

* Regenerate docs with grouped request-object examples

API reference examples now construct the single Api<Op>Request object, matching the grouped method signatures.

* Regenerate: required params + body positional, optionals in one object

API methods now take required params + body positionally, with optional params in a single Api<Op>Options object (was: one Api<Op>Request for everything). Updated SSO tests + README.

* Regenerate: single optional is a direct param (no options object for 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.

* Regenerate: mod_api/ paths + PostRemoveCommentApiResponse rename; drop 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.

* README: shorten ModerationApi description; regenerate docs (fix invalid options= synopsis)

Doc-only. Method synopses now show a valid 'options' arg instead of 'options='.

* Release v3.0.0: regenerate at 3.0.0 with fastcomments-build-20260630 jar

Bump version to 3.0.0 and regenerate from the new generator fork release.

Author: winrid

.gitignore

@@ -158,3 +158,6 @@ Thumbs.db
 # Logs
 logs/
 *.log
+
+# Local fork generator jar (downloaded on demand by update.sh)
+openapi-generator-cli.jar

README.md

@@ -18,7 +18,7 @@ This library contains two modules: the generated API client and the core Python
 
 ### Public vs Secured APIs
 
-For the API client, there are three classes, `DefaultApi`, `PublicApi`, and `ModerationApi`. The `DefaultApi` contains methods that require your API key, and `PublicApi` contains methods that can be made directly from a browser/mobile device/etc without authentication. The `ModerationApi` powers the moderator dashboard and contains methods for moderating comments (list, count, search, logs, export), moderation actions (remove/restore, flag, set review/spam/approval status, votes, reopen/close thread), bans (ban from comment, undo, pre-ban summaries, ban status/preferences, banned-user counts), and badges & trust (award/remove badge, manual badges, get/set trust factor, user internal profile). Every `ModerationApi` method accepts an `sso` parameter so it can be called on behalf of an SSO-authenticated moderator.
+For the API client, there are three classes, `DefaultApi`, `PublicApi`, and `ModerationApi`. The `DefaultApi` contains methods that require your API key, and `PublicApi` contains methods that can be made directly from a browser/mobile device/etc without authentication. The `ModerationApi` provides an extensive suite of live and fast moderation APIs. Every `ModerationApi` method accepts an `sso` parameter and can authenticate via SSO or a FastComments.com session cookie.
 
 ## Quick Start
 
@@ -50,10 +50,7 @@ try:
         display_name="John Doe"
     )
 
-    response = api.add_sso_user(
-        tenant_id="YOUR_TENANT_ID",
-        create_apisso_user_data=user_data
-    )
+    response = api.add_sso_user("YOUR_TENANT_ID", user_data)
     print(f"User created: {response}")
 
 except Exception as e:
@@ -77,10 +74,7 @@ api_client = ApiClient(configuration=config)
 public_api = PublicApi(api_client)
 
 try:
-    response = public_api.get_comments_public(
-        tenant_id="YOUR_TENANT_ID",
-        url_id="page-url-id"
-    )
+    response = public_api.get_comments_public("YOUR_TENANT_ID", "page-url-id")
     print(response)
 except Exception as e:
     print(f"Error: {e}")
@@ -92,6 +86,7 @@ The `ModerationApi` powers the moderator dashboard. Methods are called on behalf
 
 ```python
 from client import ApiClient, Configuration, ModerationApi
+from client.api.moderation_api import GetCountOptions
 
 config = Configuration()
 config.host = "https://fastcomments.com/api"
@@ -101,7 +96,7 @@ moderation_api = ModerationApi(api_client)
 
 try:
     # Count the comments awaiting moderation
-    response = moderation_api.get_count(sso="SSO_TOKEN")
+    response = moderation_api.get_count(GetCountOptions(sso="SSO_TOKEN"))
     print(response)
 except Exception as e:
     print(f"Error: {e}")

client/.github/workflows/python.yml

@@ -7,13 +7,16 @@ name: client Python package
 
 on: [push, pull_request]
 
+permissions:
+  contents: read
+
 jobs:
   build:
 
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
       - uses: actions/checkout@v4
@@ -28,4 +31,4 @@ jobs:
           pip install -r test-requirements.txt
       - name: Test with pytest
         run: |
-          pytest --cov={{packageName}}
+          pytest --cov=client

client/.gitignore

@@ -62,5 +62,5 @@ docs/_build/
 # PyBuilder
 target/
 
-#Ipython Notebook
+# Ipython Notebook
 .ipynb_checkpoints

client/.gitlab-ci.yml

@@ -14,12 +14,6 @@ stages:
    - pip install -r test-requirements.txt
    - pytest --cov=client
 
-pytest-3.8:
-  extends: .pytest
-  image: python:3.8-alpine
-pytest-3.9:
-  extends: .pytest
-  image: python:3.9-alpine
 pytest-3.10:
   extends: .pytest
   image: python:3.10-alpine
@@ -29,3 +23,9 @@ pytest-3.11:
 pytest-3.12:
   extends: .pytest
   image: python:3.12-alpine
+pytest-3.13:
+  extends: .pytest
+  image: python:3.13-alpine
+pytest-3.14:
+  extends: .pytest
+  image: python:3.14-alpine

client/.openapi-generator/FILES

@@ -273,7 +273,7 @@ client/models/patch_domain_config_response.py
 client/models/patch_page_api_response.py
 client/models/patch_sso_user_api_response.py
 client/models/pending_comment_to_sync_outbound.py
-client/models/post_remove_comment_response.py
+client/models/post_remove_comment_api_response.py
 client/models/pre_ban_summary.py
 client/models/pub_sub_comment.py
 client/models/pub_sub_comment_base.py
@@ -372,7 +372,6 @@ client/models/users_list_location.py
 client/models/vote_body_params.py
 client/models/vote_delete_response.py
 client/models/vote_response.py
-client/models/vote_response_status.py
 client/models/vote_response_user.py
 client/models/vote_style.py
 client/py.typed
@@ -638,7 +637,7 @@ docs/PatchDomainConfigResponse.md
 docs/PatchPageAPIResponse.md
 docs/PatchSSOUserAPIResponse.md
 docs/PendingCommentToSyncOutbound.md
-docs/PostRemoveCommentResponse.md
+docs/PostRemoveCommentApiResponse.md
 docs/PreBanSummary.md
 docs/PubSubComment.md
 docs/PubSubCommentBase.md
@@ -738,7 +737,6 @@ docs/UsersListLocation.md
 docs/VoteBodyParams.md
 docs/VoteDeleteResponse.md
 docs/VoteResponse.md
-docs/VoteResponseStatus.md
 docs/VoteResponseUser.md
 docs/VoteStyle.md
 git_push.sh
@@ -1009,7 +1007,7 @@ test/test_patch_domain_config_response.py
 test/test_patch_page_api_response.py
 test/test_patch_sso_user_api_response.py
 test/test_pending_comment_to_sync_outbound.py
-test/test_post_remove_comment_response.py
+test/test_post_remove_comment_api_response.py
 test/test_pre_ban_summary.py
 test/test_pub_sub_comment.py
 test/test_pub_sub_comment_base.py
@@ -1109,7 +1107,6 @@ test/test_users_list_location.py
 test/test_vote_body_params.py
 test/test_vote_delete_response.py
 test/test_vote_response.py
-test/test_vote_response_status.py
 test/test_vote_response_user.py
 test/test_vote_style.py
 tox.ini

client/.openapi-generator/VERSION

@@ -1 +1 @@
-7.11.0
+7.23.0-SNAPSHOT

client/.travis.yml

@@ -1,13 +1,13 @@
 # ref: https://docs.travis-ci.com/user/languages/python
 language: python
 python:
-  - "3.8"
-  - "3.9"
   - "3.10"
   - "3.11"
   - "3.12"
+  - "3.13"
+  - "3.14"
   # uncomment the following if needed
-  #- "3.12-dev"  # 3.12 development branch
+  #- "3.14-dev"  # 3.14 development branch
   #- "nightly"  # nightly build
 # command to install dependencies
 install: