hapi-decorators

hapi-decorators

Decorators for HapiJS routes. Heavily inspired and borrowed from https://github.com/stewartml/express-decorators

Great to mix with https://github.com/jayphelps/core-decorators.js

Usage

npm install --save hapi-decorators

/*
 * index.js
 *
 * Hapi initialization not shown, but `server` is the assumed
 * instance;
 */
import {
  get,
  controller
} from 'hapi-decorators'

@controller('/hello')
public class TestController {
  constructor(target) {
    this.target = target
  }

  @get('/world')
  sayHello(request, reply) {
    reply({ message: `hello, ${this.target}` })
  }
}

let test = new TestController('world')

server.routes(test.routes())

Setup Babel

Run the above script with the following command, after installing babel.

babel-node --optional es7.decorators,es7.objectRestSpread index.js

Note: Decorators are currently unsupported in Babel 6. To work around that issue use the transform-decorators-legacy plugin. See this post for detailed instructions.

Decorators

@controller(basePath)

REQUIRED This decorator is required at the class level, since it processes the other decorators, and adds the instance.routes() function, which returns the routes that can be used with Hapi, e.g. server.routes(users.routes()).

@route(method, path)

This decorator should be attached to a method of a class, e.g.

@controller('/users')
class Users {
  @route('post', '/')
  newUser(request, reply) {
    reply([])
  }
}

Helper Decorators

• @get(path)
• @post(path)
• @put(path)
• @patch(path)
• @delete(path)
• @all(path)

These are shortcuts for @route(method, path) where @get('/revoke') would be @route('get', '/revoke').

@config(config)

Overall configuration setting if none of the other decorators are sufficient.

@validate(validateConfig)

Add a validation object for the different types, except for the response. config is an object, with keys for the different types, e.g. payload.

@cache(cacheConfig)

Cache settings for the route config object.