feat(server): redirect replies to redirect the client to another URL with optional response status defaulting to 302.

Author: getspooky

server/api.ts

@@ -1,6 +1,7 @@
 import type { BufReader, BufWriter } from 'https://deno.land/[email protected]/io/bufio.ts'
 import type { MultipartFormData } from 'https://deno.land/[email protected]/mime/multipart.ts'
 import { MultipartReader } from 'https://deno.land/[email protected]/mime/multipart.ts'
+import { Status } from "https://deno.land/[email protected]/http/http_status.ts";
 import log from '../shared/log.ts'
 import type { APIRequest, ServerRequest, ServerResponse } from '../types.ts'
 
@@ -126,6 +127,16 @@ export class Request implements APIRequest {
     return this
   }
 
+  redirect(url: string, status: Status = Status.Found): this {
+    // "back" is an alias for the referrer.
+    if (url == "back") {
+      url = this.#resp.headers.get("Referrer") || "/"
+    }
+    this.#resp.status = status
+    this.#resp.headers.set("Location", encodeURI(url))
+    return this
+  }
+
   async send(data?: string | Uint8Array | ArrayBuffer, contentType?: string): Promise<void> {
     if (this.#resp.done) {
       log.warn('ServerRequest: repeat respond calls')

types.ts

@@ -1,5 +1,6 @@
 import type { BufReader, BufWriter } from 'https://deno.land/[email protected]/io/bufio.ts'
 import type { MultipartFormData } from 'https://deno.land/[email protected]/mime/multipart.ts'
+import type { Status } from "https://deno.land/[email protected]/http/http_status.ts"
 import { Plugin, PluginCreator } from 'https://esm.sh/[email protected]'
 
 /**
@@ -181,6 +182,8 @@ export interface APIRequest extends ServerRequest {
   send(data?: string | Uint8Array | ArrayBuffer, contentType?: string): Promise<void>
   /** `json` replies to the request with a json content. */
   json(data: any): Promise<void>
+  /** `redirect` replies to redirect the client to another URL with optional response `status` defaulting to 302. */
+  redirect(url: string, status?: Status): this
 }
 
 /**