Aleksandr Beshkenadze
cce5e5df46
feat: add OpenAPI tags for improved SDK generation and API organization (#655)
## Summary
Adds OpenAPI tags to improve SDK generation and API documentation
organization, as discussed in #644.
## Changes
- **Go Code**: Define tag metadata (name + description) in
`internal/api/router/router.go` using Huma's `api.OpenAPI().Tags`
- **Reference Spec**: Update `docs/reference/api/openapi.yaml` to match
the generated spec
- **Tags Added**: servers, publish, auth, admin, health, ping
## Benefits
- ✅ Improved SDK generation with proper service grouping (e.g.,
`serversService`, `publishService`)
- ✅ Better API documentation organization in Scalar UI, Swagger UI, and
other tools
- ✅ Code-first approach ensures reference spec stays in sync via
compliance tests
## Testing
- ✅ Compliance test passes: `go test -v ./internal/api -run
TestOpenAPIEndpointCompliance`
- ✅ All 4 reference endpoints verified as implemented
- ✅ TypeScript SDK regenerated successfully with proper tag-based
grouping
## Related
Closes #644
|
2025-10-14 14:30:36 +03:00 |
| .. |
|
api
|
feat: add OpenAPI tags for improved SDK generation and API organization (#655)
|
2025-10-14 14:30:36 +03:00 |
|
auth
|
Apply gofmt formatting to all Go files (#588)
|
2025-09-30 17:32:22 +03:00 |
|
config
|
Apply gofmt formatting to all Go files (#588)
|
2025-09-30 17:32:22 +03:00 |
|
database
|
Refactor package types to use dedicated schema types per package type (NPM, PyPI, NuGet, OCI, MCPB) (#634)
|
2025-10-11 10:53:45 +03:00 |
|
importer
|
Enforce schema validation on the publish and edit API level (#598)
|
2025-10-05 13:57:10 +01:00 |
|
service
|
Enforce schema validation on the publish and edit API level (#598)
|
2025-10-05 13:57:10 +01:00 |
|
telemetry
|
Add OpenTelemetry metrics instrumentation (#290)
|
2025-08-21 14:23:37 +01:00 |
|
validators
|
Refactor package types to use dedicated schema types per package type (NPM, PyPI, NuGet, OCI, MCPB) (#634)
|
2025-10-11 10:53:45 +03:00 |