An opinionated model loader for Bookshelf. Inspired by Ghost.
Also includes bookshelf-modelbase which the Base model.
npm install bookshelf-model-loader --save
During your application's startup phase load the module calling the init method. Pass your bookshelf instance in along with the path to the directory you want to autoload your models from.
var bookshelf = require('bookshelf')(knex);
require('bookshelf-model-loader').init(bookshelf, {
plugins: ['virtuals', 'visibility', 'registry'], // Optional - Bookshelf plugins to load. Defaults to loading the 'virtuals', 'visibility' & 'registry' plugins
excludes: [], // Optional - files to ignore
path: __dirname + '/models' // Required
modelOptions: {}, // Optional - options to pass to the base model
});Then, elsewhere in the application simply:
var Models = require('bookshelf-model-loader');Models should export an object with a key of the name you'd like to reference the model as.
For example: ./models/user.js;
'use strict';
var Models = require('bookshelf-model-loader');
var User = Models.Base.extend({
tableName: 'users'
});
module.exports = {
User: Models.Bookshelf.model('User', User)
};The model will then be available:
var Models = require('bookshelf-model-loader');
Models.User.findOne();All models provide soft deletes by default. As a result, all tables are required to have a deleted_at column. However, you can disable soft deletes on a per model or global basis.
To disable soft deletes for a particular model simply add soft: false to the model declaration.
var User = Models.Base.extend({
tableName: 'users',
soft: false
});To disable soft deletes for all models by default add the soft: false flag to the modelOptions object when calling the init() method.
var bookshelf = require('bookshelf')(knex);
require('bookshelf-model-loader').init(bookshelf, {
plugins: ['virtuals', 'visibility', 'registry'], // Optional - Bookshelf plugins to load. Defaults to loading the 'virtuals', 'visibility' & 'registry' plugins
excludes: [], // Optional - files to ignore
path: __dirname + '/models', // Required
modelOptions: {
soft: false
}
});