Add an OPTIONS request type (#215)

* Add an OPTIONS request type

* Null safety fix

Co-authored-by: Ivan Terekhin <[email protected]>

chopper/lib/src/annotations.dart

@@ -262,6 +262,20 @@ class Head extends Method {
         );
 }
 
+@immutable
+class Options extends Method {
+  const Options({
+    bool optionalBody = true,
+    String path = '',
+    Map<String, String> headers = const {},
+  }) : super(
+          HttpMethod.Options,
+          optionalBody: optionalBody,
+          path: path,
+          headers: headers,
+        );
+}
+
 /// A function that should convert the body of a [Request] to the HTTP representation.
 typedef ConvertRequest = FutureOr<Request> Function(Request request);
 

chopper/lib/src/base.dart

@@ -454,6 +454,23 @@ class ChopperClient {
         ),
       );
 
+  /// Makes a HTTP OPTIONS request using the [send] function.
+  Future<Response<BodyType>> options<BodyType, InnerType>(
+    String url, {
+    Map<String, String> headers = const {},
+    Map<String, dynamic>? parameters,
+    String? baseUrl,
+  }) =>
+      send<BodyType, InnerType>(
+        Request(
+          HttpMethod.Options,
+          url,
+          baseUrl ?? this.baseUrl,
+          headers: headers,
+          parameters: parameters,
+        ),
+      );
+
   /// Disposes this [ChopperClient] to clean up memory.
   ///
   /// **Warning**: If a custom [http.Client] was provided while creating this `ChopperClient`,

chopper/lib/src/constants.dart

@@ -12,4 +12,5 @@ class HttpMethod {
   static const String Delete = 'DELETE';
   static const String Patch = 'PATCH';
   static const String Head = 'HEAD';
+  static const String Options = 'OPTIONS';
 }

chopper/test/client_test.dart

@@ -149,6 +149,31 @@ void main() {
       expect(response.body, equals('delete response'));
       expect(response.statusCode, equals(200));
 
+      httpClient.close();
+    });
+    test('OPTIONS', () async {
+      final httpClient = MockClient((request) async {
+        expect(
+          request.url.toString(),
+          equals('$baseUrl/test/get?key=val'),
+        );
+        expect(request.method, equals('OPTIONS'));
+        expect(request.headers['foo'], equals('bar'));
+        expect(request.headers['int'], equals('42'));
+
+        return http.Response('get response', 200);
+      });
+
+      final chopper = buildClient(httpClient);
+      final response = await chopper.options(
+        '/test/get',
+        headers: {'int': '42'},
+        parameters: {'key': 'val'},
+      );
+
+      expect(response.body, equals('get response'));
+      expect(response.statusCode, equals(200));
+
       httpClient.close();
     });
   });

chopper/test/test_service.dart

@@ -21,6 +21,9 @@ abstract class HttpTestService extends ChopperService {
   @Head(path: 'head')
   Future<Response> headTest();
 
+  @Options(path: 'options')
+  Future<Response> optionsTest();
+
   @Get(path: 'get')
   Future<Response<Stream<List<int>>>> getStreamTest();
 

chopper_generator/lib/src/generator.dart

@@ -338,6 +338,7 @@ class ChopperGenerator extends GeneratorForAnnotation<chopper.ChopperApi> {
     chopper.Patch,
     chopper.Method,
     chopper.Head,
+    chopper.Options,
   ];
 
   DartType? _genericOf(DartType? type) {