@xeaone/server
v5.4.1
Published
X-Server Deno server module with built in middleware.
Downloads
10
Readme
X-Server
Deno server module with built in middleware.
Use
https://deno.land/x/xserver/src/mod.ts
Example
import { Handler, Normalize, Router, Server } from 'https://deno.land/x/xserver/src/mod.ts';
const router = new Router();
const handler = new Handler();
const normalize = new Normalize();
normalize.any('/*', true);
router.get('/*', (context) => context.html`<h1>Hello World</h1>`);
router.post('/*', (context) => context.ok({ message: 'posted' }));
handler.add(normalize);
handler.add(router);
Server((request) => handler.handle(request));
Server
Wraps Deno.serve
Handler
Constructor that stores the middleware/plugins/tools used on each request.
import { Handler, Normalize, Server } from 'https://deno.land/x/xserver/src/mod.ts';
const handler = new Handler();
const normalize = new Normalize();
handler.add(normalize);
Server((request) => handler.handle(request));
Normalize
Constructor Plugin that will remove index.html
, .html
, and //
from the url then redirect. Optionally you can redirect http
to https
and www
to non-www
.
import { Normalize } from 'https://deno.land/x/xserver/src/mod.ts';
const normalize = new Normalize();
normalize.www(true); // redirects www to non www
normalize.https(true); // redirects http to https
normalize.any('/*', true); // any method and any path Normalize
Cors
Constructor Plugin that will add cors header.
import { Cors } from 'https://deno.land/x/xserver/src/mod.ts';
const cors = new Cors();
cors.get('/foo', 'https://foo.com/'); // get method test path and CORS on only foo.com domain
cors.any('/*', '*'); // any method any path and CORS on any domain
Payload
Constructor Plugin that will parse the request body.
import { Payload } from 'https://deno.land/x/xserver/src/mod.ts';
const payload = new Payload();
payload.parse('json'); // default is json
payload.post('/*', true); // post method any path
Router
Constructor Plugin that will route request to a handle method.
import { Router } from 'https://deno.land/x/xserver/src/mod.ts';
const router = new Router();
router.post('/*', (context) => context.ok('hello world')); // post method any path
File
Constructor Plugin that will serve files. SPA mode will route all non existent files in the path folder to the /index.html
.
import { File } from 'https://deno.land/x/xserver/src/mod.ts';
const file = new File();
file.spa(true);
file.path('./web');
file.get('/*', true); // get method any path serve files from the ./web folder
Session
Constructor Plugin that will provide session using Secure Session Cookies https://tools.ietf.org/html/rfc6896.
import { Session } from 'https://deno.land/x/xserver/src/mod.ts';
const sessions = new Map();
const session = new Session();
session.validate((context) => {
const { session } = context.tool.session.data;
// return a response to prevent access end exit the handler loop early
if (!sessions.has(session)) return context.unauthorized();
});
session.secret('secret'); // unique secret
session.signature('signature'); // unique signature
session.any('/*', true); // any method and any path is protected
session.get('/*', false); // get method any path disable session protection
session.post('/sign-up', false); // post method specific path disable session protection
session.post('/sign-in', false); // post method specific path disable session protection
Forwarded
Constructor Plugin that will parse the forwarded
header.
This is good for getting client/remote IP address behind a proxy/loadbalancer.
import { Forwarded } from 'https://deno.land/x/xserver/src/mod.ts';
import { Handler, Server } from 'https://deno.land/x/xserver/src/mod.ts';
const forwarded = new Forwarded();
const handler = new Handler();
forwarded.any('/*', true); // any method and any path parse forwarded header
handler.add(forwarded);
/*
type ForwardedData = {
by: Array<string>;
for: Array<string>;
host: Array<string>;
proto: Array<string>;
};
*/
handler.add(function (context) {
const { for: [client] } = context.tool.forwarded.data;
return context.ok(client);
});
Server((request) => handler.handle(request), { port: 8080 });
Socket
Constructor Plugin that will