Document the default full Steam batch lookup response example

[coderabbitai]

Summary

The generated OpenAPI success example for games.batchBySteamAppIds currently shows the minimal result variant, while BatchBySteamAppIdsSchema.minimal defaults to false and the default response is the full result shape.

Required changes

• Update getResponseExampleOverride in src/scripts/api/generate-api-docs.ts so the BatchBySteamAppIdsResponseSchema example represents the default full response shape.
• Include the full-result fields such as steamAppId, game, matchStrategy, and the nested system and listings data.
• Alternatively, explicitly label the current example as applying to minimal: true.
• Regenerate public/api-docs/mobile-openapi.json so the documented endpoint success example matches the selected behavior.

Rationale

API consumers should be able to rely on the default request/response examples. Documenting the minimal response as the default can lead clients to model the wrong contract.

Affected areas

• src/scripts/api/generate-api-docs.ts
• public/api-docs/mobile-openapi.json

Acceptance criteria

• The generated example accurately reflects minimal: false, or is unambiguously documented as a minimal: true example.
• The OpenAPI JSON is regenerated from the updated generator.
• The endpoint documentation and response schema/example are consistent.

Backlinks

• Pull request: Server hardening #454
• Review comment: Server hardening #454 (comment)
• Requested by: @Producdevity

[coderabbitai]

🔗 Related PRs

#342 - switch to new steam api [merged]
#454 - Server hardening [open]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!