node package manager
Stop writing boring code. Discover, share, and reuse within your team. Create a free org »

waterline-nested

Waterline Nested

A simple helper, allows you to do nested creates and updates with Waterline 0.13 (Sails v1.0).

Installation

Avaliable methods

  • Nested.create(model, record)
  • Nested.createEach(model, records)
Argument Type Details
1 model String A model name.
2 record Object An Object that is to be created.
2 records Array A list of Objects to be created.

Returns: Promise

Usage

// myApp/api/models/User.js 
// A user may have many pets 
module.exports = {
  attributes: {
    firstName: {
      type: 'string'
    },
    lastName: {
      type: 'string'
    },
 
    // Add a reference to Pets 
    pets: {
      collection: 'pet',
      via: 'owner'
    }
  }
};
// myApp/api/models/Pet.js 
// A pet may only belong to a single user 
module.exports = {
  attributes: {
    breed: {
      type: 'string'
    },
    type: {
      type: 'string'
    },
    name: {
      type: 'string'
    },
 
    // Add a reference to User 
    owner: {
      model: 'user'
    }
  }
};

Now that the pets and users know about each other, they can be associated. To do this we can create or update a pet with the user's object inside.

var Nested = require('waterline-nested');
 
Nested.create('pet', {
  breed: 'labrador',
  type: 'dog',
  name: 'fido',
  owner: { // is User model. 
    firstName: {
      type: 'Dmitry'
    },
    lastName: {
      type: 'Demenchuk'
    },
  }
}).exec(function(err) {});

It will automativaly create new user and create a pet associated with that user.

TODOs

  • Add tests.
  • Find a better way to integrate waterline-nested with waterline.