trailpack
Trailpack Interface. Trailpacks extend the capability of the Trails
framework. (Application functionality should be extended using
Services).
Usage
This module is a class which should be extended by all trailpacks.
Implement
See archetype/index.js
for more details.
const Trailpack = require('trailpack')
class ExampleTrailpack extends Trailpack {
constructor (app) {
super(app, {
config: require('./config'),
api: require('./api'),
pkg: require('./package')
})
}
validate () {
if (!this.app.config.example) throw new Error('config.example not set!')
}
configure () {
this.app.config.example.happy = true
}
initialize () {
setInterval(() => this.log.debug('happy?', this.app.config.example.happy), 1000)
}
}
Configure
See archetype/config/trailpack.js
for more details.
module.exports = {
type: 'misc',
lifecycle: {
configure: [ ],
initialize: [ ]
}
}
API
Boot Lifecycle
app.start
- Validate
- Configure
- Initialize
app.ready
Types
abstract
An abstract trailpack is designed to provide an interface for a particular
kind of trailpack, and are not included directly.
system
These trailpacks provide critical framework-level functionality that most/all
other trailpacks will depend on, such as core
and router
.
server
These allow you to use various node.js web server frameworks with Trails, such
as express
,
hapi
,
and koa
. Typically, only one
server pack will be installed in a Trails Application.
datastore
Datastore trailpacks provide a unified way to configure various persistence
stores. These may be ORMs, query builders, or database drives. Examples include
knex
, graphql
and waterline
. Typically,
only one datastore pack will be installed in a Trails Application.
tools
Every application needs a suite of tools for development, debugging,
monitoring, etc. These trailpacks integrate various modules with Trails
to provide a richer developer experience. Some tool packs include
autoreload
, webpack
,
repl
. Trails Application logic
will typically not rely on these trailpacks directly.
extensions
Extension packs exist to augment, or extend, the functionality of other
trailpacks or existing framework logic.
For example, footprints
provides a standard interface between server
and datastore
trailpacks.
realtime
adds additional
functionality to a server. sails
lets you plugin an entire sails project directly into a Trails Application.
bootstrap
extends the Trails
boot process so that a custom method can be run during application startup.
Methods
constructor(app, definition)
Instantiate the Trailpack. definition
is an object which contains three
optional properties: config
, api
, pkg
. Trailpack configuration is merged
into the application configuration.
validate()
Validate the preconditions for proper functioning of this trailpack. For
example, if this trailpack requires that a database is configured in
config/database.js
, this method should validate this. This method should incur
no side-effects. Do not alter any extant configuration.
configure()
Alter/Extend the configuration (app.config
) of the application, or
add new sections to the config object for the trailpack. This method
is run before the application is loaded -- after validate, and before
initialize. Trails does not allow further configuration changes after
this lifecycle stage is complete.
initialize()
If you need to bind any event listeners, start servers, connect to databases,
all of that should be done in initialize. The app's configuration is guaranteed to be
loaded and finalized before this stage.
Contributing
We love contributions! Please see our Contribution Guide
for more information.
License
MIT