objection-bcrypt v0.1.0

Bcrypt for Objection.js

This plugin automatically adds automatic Bcrypt hashing to your Objection.js models. This makes it super-easy to secure passwords and other sensitive data.

Installation

NPM

npm i objection-bcrypt

Yarn

yarn add objection-bcrypt

Usage

Hashing your data

// import the plugin
const Bcrypt = require('objection-bcrypt')();
const Model = require('objection').Model;

// mixin the plugin
class Person extends Bcrypt(Model) {
    static get tableName() {
        return 'person';
    }
}

const person = await Person.query().insert({
    email: 'matt@damon.com',
    password: 'q1w2e3r4'
});

console.log(person.password);
// $2a$12$sWSdI13BJ5ipPca/f8KTF.k4eFKsUtobfWdTBoQdj9g9I8JfLmZty

Verifying the data

    // the password to verify
    const password = 'q1w2e3r4';

    // fetch the person by email
    const person =
        await Person.query().where({ email: 'matt@damon.com'});

    // verify the password is correct
    const passwordValid = person.verifyPassword(password);

Options

There are a few options you can pass to customize the way the plugin works.

These options can be added when instantiating the plugin. For example:

// import the plugin
const Bcrypt = require('objection-bcrypt')({
    passwordField: 'hash'
});

allowEmptyPassword (defaults to false)

Allows an empty password to be set.

passwordField (defaults to password)

Allows you to override the name of the field to be hashed.

rounds (defaults to 12)

The number of number of Bcrypt rounds to use when hashing the data.