Hapi-compat NPM

hapi-compat

This plugin tries to detect, warn and auto-fix Hapi 17 breaking changes which are not fixed in plugins with a best effort.

Hooks are recursive so if a plugin requires incompatible plugins, hapi-compat plugin will support them too.

ID	Auto Fix	Perf Impact	Description
ASYNC_PLUGINS	YES	I	plugins with next callback should return a Promise now
SERVER_REGISTER	YES	-	`server.register({ register })` should be `{ plugin }`
PLUGIN_ATTRS	YES	-	`register.attributes` ~> `{register, pkg}`
SERVER_ON	YES	I + R	`server.on` ~> `server.events.on`
ASYNC_SERVER_EXT	YES	I	Support for server.ext where the method expects having `next` callback

Perf Impact indicates if this support impacts performance of framework (I)init or (R)untime.
* means only impacts perf when old code detected not newer plugins

For more details please look at breaking changes list here

Install package:

npm install hapi-compat

# or using yarn...

yarn add hapi-compat

Add plugin and push main Hapi instance as options.server to allow globally registering hooks:

// ...
const server = new Hapi.Server(....)

// ...
server.register({
    plugin: 'hapi-compat',
    options: {
        server
    }
})

Does this plugin magically fixes everything for migration?
Absolutely no. This is just a helper utility for making migration easier and faster.

Released under The MIT LICENSE

7 years ago

7 years ago