Skip to content

events: document follow/follow_state/followers/comments in swagger#776

Merged
dylanjeffers merged 1 commit intomainfrom
update-follow-comments-swagger
Apr 22, 2026
Merged

events: document follow/follow_state/followers/comments in swagger#776
dylanjeffers merged 1 commit intomainfrom
update-follow-comments-swagger

Conversation

@dylanjeffers
Copy link
Copy Markdown
Contributor

These handlers existed on the Go side already (v1EventFollowState, postV1EventFollow, deleteV1EventFollow, v1EventComments, plus the new v1EventsFollowers) but never got entries in the hand-maintained swagger-v1.yaml. As a result the SDK generator — which reads that YAML — produced no TS types for them, and every consumer had to either hand-stub the types or route through the entity-manager escape hatch.

Adds paths for:

  • GET /events/{eventId}/comments → track_comments_response
  • POST /events/{eventId}/follow → write_response (auth required)
  • DELETE /events/{eventId}/follow → write_response (auth required)
  • GET /events/{eventId}/follow_state → event_follow_state_response
  • GET /events/{eventId}/follow-state → event_follow_state_response
    (hyphenated alias)
  • GET /events/{eventId}/followers → followers_response

Adds event_follow_state / event_follow_state_response schemas. Other endpoints reuse existing track_comments_response / write_response / followers_response shapes since the response envelopes are identical.

These handlers existed on the Go side already (v1EventFollowState,
postV1EventFollow, deleteV1EventFollow, v1EventComments, plus the new
v1EventsFollowers) but never got entries in the hand-maintained
swagger-v1.yaml. As a result the SDK generator — which reads that YAML
— produced no TS types for them, and every consumer had to either
hand-stub the types or route through the entity-manager escape hatch.

Adds paths for:
- GET  /events/{eventId}/comments      → track_comments_response
- POST /events/{eventId}/follow        → write_response (auth required)
- DELETE /events/{eventId}/follow      → write_response (auth required)
- GET  /events/{eventId}/follow_state  → event_follow_state_response
- GET  /events/{eventId}/follow-state  → event_follow_state_response
                                         (hyphenated alias)
- GET  /events/{eventId}/followers     → followers_response

Adds event_follow_state / event_follow_state_response schemas. Other
endpoints reuse existing track_comments_response / write_response /
followers_response shapes since the response envelopes are identical.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@dylanjeffers dylanjeffers merged commit 6ba3323 into main Apr 22, 2026
5 checks passed
@dylanjeffers dylanjeffers deleted the update-follow-comments-swagger branch April 22, 2026 00:11
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