Refactor role-based access control

[moutonjeremy]

Enhance route authorization by implementing declarative role checks using RequiredRoles. Introduce the WithRoles helper function for appending roles, validate roles in the input parsing, and update OpenAPI specifications to include required roles. Add comprehensive tests for the new functionality.

[Copilot]

Pull request overview

This PR refactors route authorization to support declarative role checks via OpenAPIOptions.RequiredRoles, adds a WithRoles helper, and exposes required roles in generated OpenAPI as an extension.

Changes:

• Add RequiredRoles to OpenAPIOptions and a WithRoles(...) helper for composing role requirements.
• Enforce required roles during request parsing/authorization and include x-required-roles in the generated OpenAPI operation objects.
• Add tests validating role enforcement and OpenAPI extension output; update the auth example to use declarative roles.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
types.go	Adds RequiredRoles to operation options and modernizes some interface{} types to any.
fiberoapi.go	Emits x-required-roles OpenAPI extension per operation.
common.go	Invokes role validation during request parsing when authorization is enabled.
auth.go	Introduces validateRequiredRoles helper for role enforcement.
auth_helpers.go	Adds WithRoles helper for appending required roles.
auth_test.go	Adds tests for role enforcement and OpenAPI extension emission.
_examples/auth/main.go	Updates example routes to use RequiredRoles/RequiredPermissions instead of manual checks.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.