Add shortcut for using a custom catch-all handler (#17)

* Add mechanism for using a custom catch-all handler

Implemented as an option to server instantiation.

* use existing utility to set http status code

* update mechanism of adding the catchAll handler via server options

It now internally uses the router catch-all

* Simplify route matching logic

* Update to std@v0.56.0

* Simplify request configuration

* Simplify syntax in code example

Co-authored-by: Seth Holladay <me@seth-holladay.com>

Author: npup

README.md

@@ -198,6 +198,20 @@ const server = pogo.server();
 
 Type: `object`
 
+##### catchAll
+
+Type: `function`
+
+Optional route handler to be used as a fallback for requests that do not match any other route. This overrides the default 404 Not Found behavior built into the framework. Shortcut for `server.router.all('/{catchAll*}', catchAll)`.
+
+```js
+pogo.server({
+    catchAll(request, h) {
+        return h.response('the void').code(404);
+    }
+});
+```
+
 ##### certFile
 
 Type: `string`\

dependencies.ts

@@ -1,8 +1,8 @@
 import React from 'https://dev.jspm.io/react@16.12.0';
 import ReactDOMServer from 'https://dev.jspm.io/react-dom@16.12.0/server';
-import * as cookie from 'https://deno.land/std@v0.53.0/http/cookie.ts';
-import * as http from 'https://deno.land/std@v0.53.0/http/server.ts';
-import { Status as status, STATUS_TEXT as statusText } from 'https://deno.land/std@v0.53.0/http/http_status.ts';
+import * as cookie from 'https://deno.land/std@v0.56.0/http/cookie.ts';
+import * as http from 'https://deno.land/std@v0.56.0/http/server.ts';
+import { Status as status, STATUS_TEXT as statusText } from 'https://deno.land/std@v0.56.0/http/http_status.ts';
 
 export {
     React,

dev-dependencies.ts

@@ -2,7 +2,7 @@ import {
     assert,
     assertEquals,
     assertStrictEq
-} from 'https://deno.land/std@v0.53.0/testing/asserts.ts';
+} from 'https://deno.land/std@v0.56.0/testing/asserts.ts';
 
 export {
     assert,

example/simple-server/dev-dependencies.ts

@@ -1,4 +1,4 @@
-import { assertEquals, assertStrictEq } from 'https://deno.land/std@v0.53.0/testing/asserts.ts';
+import { assertEquals, assertStrictEq } from 'https://deno.land/std@v0.56.0/testing/asserts.ts';
 
 export {
     assertEquals,

lib/request.ts

@@ -14,7 +14,7 @@ export default class Request {
     route: MatchedRoute;
     method: string;
     headers: Headers;
-    params: RequestParams
+    params: RequestParams;
     referrer: string;
     response: Response;
     server: Server;

lib/server.ts

@@ -35,6 +35,10 @@ export default class Server {
             ...options
         };
         this.router = new Router();
+        const { catchAll } = this.options;
+        if (typeof catchAll === 'function') {
+            this.router.all('/{catchAll*}', catchAll);
+        }
     }
     async inject(rawRequest: http.ServerRequest): Promise<Response> {
         const route = this.router.lookup(rawRequest.method, getPathname(rawRequest.url));

lib/types.ts

@@ -25,10 +25,11 @@ export interface MatchedRoute extends NormalizedRoute {
 }
 
 export interface ServerOptions {
-    hostname?: string,
-    port: number,
+    catchAll?: RouteHandler,
     certFile?: string,
-    keyFile?: string
+    hostname?: string,
+    keyFile?: string,
+    port: number
 }
 
 type JSONStringifyable = boolean | null | number | object | string;

test/server.jsx

@@ -433,3 +433,46 @@ test('server.route() handler throws bang.badRequest()', async () => {
         status  : 400
     }));
 });
+
+test('server catchAll option', async () => {
+    const server = pogo.server({
+        catchAll(request, h) {
+            return h.response('Custom fallback, ' + request.method).code(418);
+        }
+    });
+    server.route({
+        method : 'GET',
+        path   : '/hello',
+        handler(request) {
+            return 'Hi, ' + request.method;
+        }
+    });
+    const getHelloResponse = await server.inject({
+        method : 'GET',
+        url    : '/hello'
+    });
+    const getRootResponse = await server.inject({
+        method : 'GET',
+        url    : '/'
+    });
+    const getVoidResponse = await server.inject({
+        method : 'GET',
+        url    : '/void'
+    });
+    const postVoidResponse = await server.inject({
+        method : 'POST',
+        url    : '/void'
+    });
+    assertStrictEq(getHelloResponse.status, 200);
+    assertStrictEq(getHelloResponse.headers.get('content-type'), 'text/html; charset=utf-8');
+    assertStrictEq(getHelloResponse.body, 'Hi, GET');
+    assertStrictEq(getRootResponse.status, 418);
+    assertStrictEq(getRootResponse.headers.get('content-type'), 'text/html; charset=utf-8');
+    assertStrictEq(getRootResponse.body, 'Custom fallback, GET');
+    assertStrictEq(getVoidResponse.status, 418);
+    assertStrictEq(getVoidResponse.headers.get('content-type'), 'text/html; charset=utf-8');
+    assertStrictEq(getVoidResponse.body, 'Custom fallback, GET');
+    assertStrictEq(postVoidResponse.status, 418);
+    assertStrictEq(postVoidResponse.headers.get('content-type'), 'text/html; charset=utf-8');
+    assertStrictEq(postVoidResponse.body, 'Custom fallback, POST');
+});