api: Implement ApiConnection.delete

Author: chrisbobbe

lib/api/core.dart

@@ -147,6 +147,16 @@ class ApiConnection {
       ..files.add(http.MultipartFile('file', content, length, filename: filename));
     return send(routeName, fromJson, request);
   }
+
+  Future<T> delete<T>(String routeName, T Function(Map<String, dynamic>) fromJson,
+      String path, Map<String, dynamic>? params) async {
+    final url = realmUrl.replace(path: "/api/v1/$path");
+    final request = http.Request('DELETE', url);
+    if (params != null) {
+      request.bodyFields = encodeParameters(params)!;
+    }
+    return send(routeName, fromJson, request);
+  }
 }
 
 ApiRequestException _makeApiException(String routeName, int httpStatus, Map<String, dynamic>? json) {

test/api/core_test.dart

@@ -104,6 +104,36 @@ void main() {
     checkRequest(['asdf'.codeUnits], 100, null);
   });
 
+  test('ApiConnection.delete', () async {
+    Future<void> checkRequest(Map<String, dynamic>? params, String expectedBody, {bool expectContentType = true}) {
+      return FakeApiConnection.with_(account: eg.selfAccount, (connection) async {
+        connection.prepare(json: {});
+        await connection.delete(kExampleRouteName, (json) => json, 'example/route', params);
+        check(connection.lastRequest!).isA<http.Request>()
+          ..method.equals('DELETE')
+          ..url.asString.equals('${eg.realmUrl.origin}/api/v1/example/route')
+          ..headers.deepEquals({
+            ...authHeader(email: eg.selfAccount.email, apiKey: eg.selfAccount.apiKey),
+            if (expectContentType)
+              'content-type': 'application/x-www-form-urlencoded; charset=utf-8',
+          })
+          ..body.equals(expectedBody);
+      });
+    }
+
+    checkRequest(null,                                   '', expectContentType: false);
+    checkRequest({},                                     '');
+    checkRequest({'x': 3},                               'x=3');
+    checkRequest({'x': 3, 'y': 4},                       'x=3&y=4');
+    checkRequest({'x': null},                            'x=null');
+    checkRequest({'x': true},                            'x=true');
+    checkRequest({'x': 'foo'},                           'x=%22foo%22');
+    checkRequest({'x': [1, 2]},                          'x=%5B1%2C2%5D');
+    checkRequest({'x': {'y': 1}},                        'x=%7B%22y%22%3A1%7D');
+    checkRequest({'x': RawParameter('foo')},             'x=foo');
+    checkRequest({'x': RawParameter('foo'), 'y': 'bar'}, 'x=foo&y=%22bar%22');
+  });
+
   test('API success result', () async {
     await FakeApiConnection.with_(account: eg.selfAccount, (connection) async {
       connection.prepare(json: {'result': 'success', 'x': 3});