node package manager



NPM version Build Status Talk topic

Factory/Loader of mongoose

Deal with what

  • A rpc server for querying mongodb.
  • Exchange data/message cross applications.
  • Listen for the data's change and emit events.


  • mongo query via mongoose api
  • rpc query via rpc methods

Overwrite the mongoose model methods

AFAIK, we can use hooks or so called middlewares to modify the mongoose model object before save and remove functions, but it does not works on update function. There was even leaded to an argument on github, but the maintainers still don't pay their attension on this issue. So I decide to use some tricks to overwrite the mongoose model methods, and make the hooks work. For example, we have an update function in model, we need update the updatedAt key when we save data by update function, we can overwrite this function.

_update = UserModel.update
UserModel.update = (conditions, update) ->
  update.updatedAt or= new Date
  _update.apply thisarguments

In limbo, we supply an overwrite function to help you overwrite the same name function of each model.

limbo = require 'limbo'
db = limbo.use 'test',
  conn: mongoose.createConnection 'mongodb://localhost/test'
# Overwrite the update function 
db.loadOverwrite 'update'(_update) ->
  (conditions, update) ->
    update or= new Date
    _update.apply thisarguments
# Load schemas 
db.loadSchema 'User'UserSchema
# Then each update function will auto update the updateAt key when executed 

We use a currying way to ensure your function recieve the exactly arguments by the user given. So the origin function of model will give you in the wrapper function (in this example, it is _update).

As the same as loadStatics and loadMethods in limbo, the loadOverwrite function also have a plural version: loadOverwrites, you can pass a group of overwrite function to it.


  • axon/axon-rpc limbo use axon as message-oriented middleware, and use axon as rpc middleware.



Some methods in rpc provider is not enabled, here is some examples:

  1. method chain cross functions is not allowed:

db.user.find({}).limit(1).exec(callback) => db.user.find({}, {limit: 1}, callback)

  1. RegExp in conditions is not allowed:

db.user.find({email: /}, {limit: 1}, callback) => db.user.aggregate([{$match: {'email': {$regex: ''}}}, {$limit: 1}])

  1. aggregate function in mongoose do not auto cast variables to ObjectId or anything else, so you should take case of these variables and do not use them in the rpc provider. (for the reason JSON only accept data)



  • emit bind event when methods are loaded from rpc server


  • remove mongoose dependency and change the initial function


  • get rid of mongoose 3.8.17 (bugness) and use a lenient dependence


  • fix the confliction of _fn in coffeescript


  • forget manager, use model now
  • merge bind and enableRpc to one method: enableRpc
  • loadStatics, loadMethods and loadOverwrites in mongo provider
  • use the load prefix on all loading methods


  • auto detective provider


  • auto convert bind port to number


  • the rpc provider now support method chain (only use it after the connect callback)


  • move bind method to mongo provider
  • support connect to different ports in different rpc instance
  • remove _methods in exposed methods


  • the managers extends limbo.Manager will bind all methods to the manager itself.


  • event support for rpc call


  • support query by mongo/rpc provider
  • auto provide a rpc server so you can query via tcp connect


  • only readme