zhaoyao91 / the-http

A toolkit to help build HTTP service.

The HTTP (TH)

A toolkit to help build HTTP service.

Features

• Modern: Using async/await instead of callback
• Simple: Simple function model: async (request) => response
• Extensible: Via making and composing intuitive wrappers
• Standard: Just HTTP
• Micro: Suitable for micro service

Categories

• Motivation
• Install
• Getting Started
• API

Install

npm i --save the-http

Getting Started

const {Response, compose, handleErrors, listen} = require('the-http') 

async function handler(request) {
  const {name, age} = await request.body.asJSON()
  return Response.withJSONBody({
    isAdult: age >= 18,
    message: `Hello ${name}`
  })
}

const enhancedHandler = compose(
  handleErrors()
)(handler)

listen(3000)(enhancedHandler)

See RequestBody, Request, Response and more in API doc.

Awesome List

• the-http-router

License

MIT

the-http's Issues

Build some helpful wrappers

• router
• cors
• validator

Thought about v2

• get rid of lower node http module concept
• use conversion over type or class
  • throw normal error
  • input args are normal object
  • support common output types
• using js-type-language to doc api
• keep core simple, do not include any utils or helpers
• ship with generally proper built-in error handling logic

Add Tests

Optimize adapt and listen logic

It's strange currently to handle errors with 2 similar logics.

Update to version 1.0.0

Review the API design. If no change, release version 1.0.0.