@knorm/knorm

@knorm/knorm

A purely ES6 class-based ORM for Node.js.

Knorm is a collection of classes that allow creating JavaScript ORMs to make it easier to work with relational databases.

Knorm can be used on any existing database without requiring any changes to the database layer. Also, knorm does not create or run any database migrations (creating or altering tables, columns, indexes etc).

You may also use it to create ORMs on the browser (e.g. for data validation).

Features

• validation, including validation for JSON fields (similar to Mongoose JS)
• plugin support
• transactions
• relations through SQL joins
• field-name to column-name mapping (e.g. snake-casing)
• virtual fields with support for async getters
• value casting before save and after fetch
• custom error classes for database errors
• extensive test coverage

Supported environments

These environments are currently supported:

Environment	Value	Description
Node.js	Version >= 7.6.	Knorm uses async/await
Databases	PostgreSQL	via @knorm/postgres plugin

Credits

Knorm is inspired by the Mongoose JS and Bookshelf.js APIs. It was previously a built as a wrapper around Knex.js, hence the kn-orm name i.e. knex-orm; but it now builds it's own SQL via SQL Bricks.js.

Thank you Ramsés Cabello for the logo.