Odme NPM | npm.io

odme

ODME is not an ODM library. It helps you create a class to keep model logic and has some default logic such as setter, getter, masking and creating id with prefixes. All these behaviours can be changed easily at defining your modle classes. It has an extension to support Couchbase and you can add your own extension to support other storages.

Full documation can be found here.
Source code is available at here.

How to use

You can create your model classes extending Base class of odme.

Base = require('odme').Base

class User extends Base
  
  props: {
    name:
      schema: Joi.string()
      whiteList: true
    age: 
      schema: Joi.number().min(0)
      whiteList: true
    total_logins: 
      schema: Joi.number().min(0)
      whiteList: false
  }

  user = new User { name: 'Arash', age: 32, city: 'Sydney', total_logins:10 }
  console.log user.key     #user_mJLGt-e6
  console.log user.doc     
    # { 
    #   name: 'Arash',
    #   age: 32,
    #   docType: 'user',
    #   docKey: 'user_mJLGt-e6' 
    # }
  console.log user.mask()
    # { 
    #   name: 'Arash',
    #   age: 32,
    #   docType: 'user',
    #   docKey: 'user_mJLGt-e6' 
    # }

  user.doc.city = 'Tehran'
  console.log user.doc
    # { 
    #   name: 'Arash',
    #   age: 32,
    #   city: 'Tehran',
    #   docType: 'user',
    #   docKey: 'user_mJLGt-e6' 
    # }
  console.log user.mask()
    # { 
    #   name: 'Arash',
    #   age: 32,
    #   docType: 'user',
    #   docKey: 'user_mJLGt-e6' 
    # }
  console.log user.mask('name,city')
    # { 
    #   name: 'Arash',
    #   city: 'Tehran'
    # }

You can extend Base class based on your adapters and set a library as source to store your doc property in key of your model object. Check odme and Couchbase integration here.

  Base = require('../build/main').CB
  
  db = new require('puffer') { host: 'localhost', name: 'test' }, true
  
  class Recipe extends Base
    source: db
    props: {
      name: 
        schema: Joi.string(),
        whiteList: true
      ingredients: 
        schema: Joi.array().items(Joi.string())
        whiteList: true
    }
  
  recipe = new Recipe { name: 'Pasta', ingredients: ['pasta', 'basil', 'olive oil'] }

  console.log recipe.key # recipe_yHr0blT
  recipe.save().then ->
    
    #after save you can get it like this
    Recipe.get(recipe.key).then (o) ->
      console.log o # return Recipe object

How to read this doc?

Base class is holding all the logic related to how to get a document and store it in the model class and how it will masked on outputs. Extensions such as CB are doing CRUD operations on models.

Need more?

Find the full list of available methods here.
This documentation is generated by groc, you can make a copy of in your local version.
You can run tests locally by npm test. Make sure you have development dependencies installed.