mio

Modern idiomatic models for the browser and node.js.

Promise and co/generator support
Restrict enumerable properties to defined model attributes.
Events emitted for initialization, attribute changes, errors, etc.
Attribute validators and defaults.
Computed properties (accessors) and sealed models.
Usable seamlessly across the browser and server.
Plugins specific to environment.
Tests and MIT license.

Installation

Using npm:

npm install --save mio

Using bower:

bower install --save mio

Example

var User = require('mio').createModel('user');

User
  .attr('id', {
    primary: true
  })
  .attr('name')
  .attr('created_at', {
    default: function() {
      return new Date();
    }
  });

var user = new User({ name: 'alex' });

Community

Plugins
Wiki
##mio on irc.freenode.net

API

mio.createModel(name[, options])

Create new model constructor with given name and options.

Options:

thunks If true, wraps methods to return thunks for use with visionmedia/co (default:false).
promises Use function to wrap methods to return promises (default: false).

var User = require('mio').createModel('user');

With promises using then/promise:

Var User = require('mio').createModel('user', {
  promisify: function(fn) {
    return require('promise).denodeify(fn);
  }
});

Model.attr(name[, options])

Define an attribute with given name and options.

User.attr('created_at', {
  default: function() {
    return new Date();
  }
});

options

default default value or function returning value.
filtered if true prevents attribute from being enumerated
get getter function returning attribute value
primary use this attribute as primary key/id (must be unique)

Model.use(fn)

Use a plugin function that extends the model. Function is called with Model as the context and Model as the argument.

User
  .use(require('example-plugin'))
  .browser(function() {
    this.use(require('mio-ajax'));
  })
  .server(function() {
    this.use(require('mio-mysql'));
  });

Model.browser(fn)

Called when installed using bower or component.

Model.server(fn)

Called when installed using npm.

Model.type

var User = mio.createModel('user');

console.log(User.type);
// => "User"

Model.options

Plugins should use this object to store options.

Model.find(id|query, callback)

User.find(123, function(err, user) {
  // ...
});

Model.findAll(query, callback)

User.findAll({
  approved: true
}, function(err, collection) {
  console.log(collection);
  // => [user1, user2, user3, ...]
});

Model.count(query, callback)

User.count(function(err, count) {
  console.log(count);
  // => 47
});

Model#save(callback)

user.save(function(err) {
  // ...
});

Model#remove(callback)

user.remove(function(err) {
  // ...
});

Model#[attr]

Model#isNew()

Model#isDirty()

Whether the model has attributes that have changed since last sav.

Model#changed()

Return attributes changed since last save.

Model#has(attribute)

Model#extras

A mutable object for saving extra information pertaining to the model instance.

Plugins

Plugins are any function registered using Model.use(), Model.browser(), or Model.server(). Functions are invoked with the Model as both context and argument.

User.use(function() {
  this.prototype.customModelMethod = function() {
    // ...
  };
});

Stores

Stores are plugins that persist models to storage layer(s).

If querying for model(s), each store method is called until the model is found. Conversely, for save and remove methods each store method is called unless an error occurs.

See mio-ajax and mio-mysql for examples of implementing a storage plugin.

Model.use(method, fn)

Use store fn for given model method.

Valid methods are "findAll", "find", "count", "save", and "remove".

Events

Model events

after remove
after save
attribute Receives arguments name and params.
before remove
before save
change Receives arguments model, name, value, and prev.
change:[attr] Receives arguments model, value, and prev.
initializing Receives arguments model and attributes.
initialized Receives argument model.
setting Receives arguments model and attributes.
error Receives arguments model and error.

Instance events

after remove
after save
before remove
before save
change Receives arguments name, value, and prev.
change:[attr] Receives arguments value, and prev.
error Receives argument error.
setting Receives argument attributes.

tv / mio

mio