feat: adds Response Moved Permanently (#771)

Co-authored-by: Renan <[email protected]>
Co-authored-by: Alejandro Santiago <[email protected]>

Author: 3 people

packages/dart_frog/lib/src/response.dart

@@ -60,6 +60,26 @@ class Response {
           },
         );
 
+  /// Create a [Response] Moved Permanently.
+  ///
+  /// This indicates that the requested resource has moved permanently to a new
+  /// URI. [location] is that URI. It's automatically set as the Location
+  /// header in [headers].
+  Response.movedPermanently({
+    required String location,
+    String? body,
+    Map<String, Object> headers = const <String, Object>{},
+    Encoding? encoding,
+  }) : this(
+          statusCode: 301,
+          headers: {
+            ...headers,
+            'Location': location,
+          },
+          body: body,
+          encoding: encoding,
+        );
+
   Response._(this._response);
 
   shelf.Response _response;

packages/dart_frog/test/src/response_test.dart

@@ -196,5 +196,66 @@ void main() {
         );
       });
     });
+
+    group('movedPermanently', () {
+      test('has correct location url', () {
+        final response = Response.movedPermanently(
+          location: 'test-location',
+        );
+        expect(
+          response.headers[HttpHeaders.locationHeader],
+          equals('test-location'),
+        );
+      });
+
+      test('has correct body', () {
+        final response = Response.movedPermanently(
+          location: 'location',
+          body: 'body',
+        );
+        expect(response.body(), completion('body'));
+      });
+
+      test('has correct body (string)', () {
+        final response = Response.movedPermanently(
+          location: 'location',
+          body: 'body',
+        );
+        expect(response.body(), completion('body'));
+      });
+
+      test('has correct body (empty)', () {
+        final response = Response.movedPermanently(
+          location: 'location',
+        );
+        expect(response.body(), completion(isEmpty));
+      });
+
+      test('has correct body (json)', () {
+        final response = Response.movedPermanently(
+          location: 'location',
+          body: jsonEncode(
+            <String, dynamic>{'foo': 'bar'},
+          ),
+        );
+        expect(
+          response.json(),
+          completion(<String, dynamic>{'foo': 'bar'}),
+        );
+      });
+
+      test('has correct headers', () {
+        const headers = <String, String>{'foo': 'bar'};
+        final response = Response.movedPermanently(
+          location: 'location',
+          headers: headers,
+        );
+        expect(response.headers['foo'], equals('bar'));
+        expect(
+          response.headers[HttpHeaders.locationHeader],
+          equals('location'),
+        );
+      });
+    });
   });
 }