blini v0.0.0

blini is a modern ORM for MongoDB based on immutable data structure and promises.

Blini is currently in alpha. API may changed, don't use it for production applications.

Example

import { Schema, Type, Model, Connection } from 'blini'
const connection = new Connection('mongodb://localhost/test')

const postSchema = new Schema({
    title: Type.String(),
    views: Type.Set(Type.String)
})

class Post extends Model(postSchema, connection, 'Cat') {
    get summary() {
        return `Post ${this.title},  ${this.likes.size} readers`
    }

    addView(ip) {
        const { views } = this;
        return this.merge({
            views: views.add(ip)
        })
    }
}

const post = new Post({ title: 'My Super blog post' })

post.addView('127.0.0.1').save()
    .then(function(savedPost) {
        console.log(savedPost.summary)
    })

Why?

First of all, this library is a Work-In-Progress and Proof-Of-Concept.

Before creating Blini, I've used a lot Mongoose for production applications, Blini borrowed a few concepts from it.

Principles

Blini tries to solve the question of "Why?" with a few principles:

1. Immutable data: By using Immutable.js, the Blini is built in a stateless fashion using immutable data structures, which leads to much easier to reason about code, and a much easier time working with data sets.

2. Simplicity: Blini tries to reduce the number of concepts and provide a unified API (it doesn't support callback, etc).

3. Composition: Instead of relying on a custom plugins logic to handle extensibility, it uses ES6 classes inheritances and compositions to extend models behavior.

4. Intuitive Data Structure: By using Immutable.js iterable data structure (List, Map and Set), it makes easier to manipulate document.

Documentation

If you're using Blini for the first time, check out the Getting Started guides and the Core Concepts to familiarize yourself with Blini's architecture and mental models. Once you've gotten familiar with those, you'll probably want to check out the full API Reference.

• Guides
  • Getting started
  • Create a Schema
  • Querying
  • Populating references
• References
  • Connection
  • Types
  • Validations
  • Document

Contributing!

All contributions are super welcome!

Blini is Apache-licensed.