Close the loop with relations

[neumino]

Thinky was designed to work well with saved relations.

People sometimes just want to just save a relation. This leads to multiple issues like #29, #245, #309 etc.

I'll add a method addRelation and removeRelation that will update only relations. The expectation being that all the documents exists, only the relation is missing.

API:

Query.prototype.addRelation(field, joinedDocument);

• for hasOne and hasMany, the primary key of joinedDocument is required
• for belongsTo, the primary key or the joined field of joinedDocument is required
• for hasAndBelongsToMany, the primary key or the joined field of joinedDocument is required

The last constraint will be for v1 that Query must return a document so the query is probably something like model.get(<x>)

Query.prototype.removeRelation(field[, joinedDocument])

• for hasOne and belongsTo, joinedDocument is not needed
• for hasMany and hasAndBelongsToMany, if joinedDocument is not provided, all relations will be removed

Same constraint as for addRelation, query must return a document.

[neumino]

In 2.1.1

[esatterwhite]

@neumino Could you add this explaination to the documentation w/ an example. Would be very helpful.

Thanks.

[neumino]

The tests have a few examples
https://github.com/neumino/thinky/blob/master/test/query.js#L832

I'll try to add them on the website.

[esatterwhite]

addRelation doesn't seem too be on the Document class either. removeRelation is there.

[neumino]

Added in 2.3.5