Feature/support metadata from swagger request

[Ali1Ammar]

This PR introduces a powerful new pattern that allows Chopper interceptors to access the data of our API Swagger request

We've created a SwaggerMetaData class that carries endpoint-specific details—like security schemes and tags—and injects this data into the request lifecycle using Chopper's @Tag() feature.

Motivation
Previously, our interceptors operated with limited context. An AuthInterceptor, for example, had no easy way to know if a specific endpoint required authentication, often leading to brittle logic that applied headers to all requests. This change allows us to build smarter, context-aware interceptors that act based on the endpoint's formal definition.

Implementation
The code generator now creates a SwaggerMetaData object for each API method, populated with data from the Swagger spec. This object is passed as a tag, making it available within any interceptor.

This enables cleaner, more reliable logic. For instance, the AuthInterceptor can now simply check if the endpoint's metadata includes the BearerAuth security requirement before attaching a token.

  @POST(path: '/example/example', optionalBody: true)
  Future<chopper.Response<ExampleExamplePost$Response>> _exampleExamplePost({
    @Body() required ExampleExamplePost$RequestBody? body,
    @chopper.Tag()
    SwaggerMetaData swaggerMetaData = const SwaggerMetaData(
      summary: '',
      description: 'This endpoint is for STUDENT',
      operationId: '',
      consumes: [],
      produces: [],
      security: ["BearerAuth"],
      tags: ["STUDENT", "example"],
      deprecated: false,
    ),
  });

class AuthInterceptor implements Interceptor {
  late final Future<String> Function() getToken;

  @override
  FutureOr<Response<BodyType>> intercept<BodyType>(
      Chain<BodyType> chain) async {
    var request = chain.request;
    if (request.tag case SwaggerMetaData swaggerMetaData
        when swaggerMetaData.security.contains('BearerAuth')) {
      final token = await getToken();
      request = applyHeader(
        request,
        HttpHeaders.authorizationHeader,
        'Bearer $token',
        override: false,
      );
    }

    final response = await chain.proceed(request);
    return response;
  }
}

[diegotori]

@Vovanella95 ball's in your court.