Fix/issue 485 openapi examples

[Agencybuilds]

Closes #485

Description

This PR addresses the backend issue for the GrantFox FWC26 campaign (Stellar Wave) by implementing structured example request/response bodies for the /api/users endpoints in openapi.yaml.

Changes Made

• OpenAPI Registry Updates: Added examples blocks for all HTTP error responses (400, 401, 404) across the following endpoints in src/openapi/registry.ts:
  • GET /api/users/me
  • GET /api/users/{address}/predictions
  • GET /api/users/{stellarAddress}/profile
  • POST /api/users/{addr}/follow
  • DELETE /api/users/{addr}/follow
• Spec Generation: Ran npm run openapi:generate to output the updated OpenAPI definitions to openapi.yaml.
• Test Coverage: Expanded tests/openapi.users.examples.test.ts to assert that the generated openapi.yaml correctly contains the new 400, 401, and 404 error examples.

Requirements Checklist

• Example request/response bodies added for /api/users in openapi.yaml.
• Focused tests added for the change and achieving test coverage guidelines.
• Input validation examples follow the standardized error envelope schema.
• Passed automated verification and formatting checks.

[drips-wave]

@Agencybuilds Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits