Adds related resource identifier object to the relationship data.

Also sets or adds to the content of the related proxy object.

• For to-many relations the related identifier object is added to the resource linkage data array.
• For to-one relations the resource identifier object is assigned, so the relation may be replaced.

See:

• http://jsonapi.org/format/#document-resource-object-linkage
• http://jsonapi.org/format/#document-resource-identifier-objects

Utility helper to setup a computed property for a resource attribute, imported and exported with the resource submodule.

An attr of the resource is a computed property to the actual attribute in an attributes hash on the resource (model) instance. Using attr() supports any type, and an optional type (String) argument can be used to enforce setting and getting with a specific type. 'string', 'number', 'boolean', 'date', 'object', and 'array' are all valid types for attributes.

Use attr(), with optional type argument, to compose your model attributes, e.g:

import Ember from 'ember';
import Resource from 'ember-jsonapi-resources/models/resource';
import { attr, toOne, toMany } from 'ember-jsonapi-resources/models/resource';

export default Resource.extend({
  type: 'articles',
  service: Ember.inject.service('articles'),

  title: attr('string'),
  published: attr('date'),
  tags: attr('array'),
  footnotes: attr('object'),
  revisions: attr()
  version: attr('number'),
  "is-approved": attr('boolean')
});

To protect the JSON API Resource properties for attributes, links and relationships these objects are setup during create(). This has to be defined since the attr() helper needs to have new objects for each instance, to project from keeping a reference on the prototype.

The create method should only be called after looking up a factory from the container, for example in a route's model hook:

model() {
  let owner = Ember.getOwner(this);
  return owner._lookupFactory('model:post').create({
    attributes: {
      title: 'The JSON API 1.0 Spec Rocks!'
    }
  });
}

The create method uses the container to lookup the factory's prototype and find the computed properties used for relations to setup the relationships for the Resource instance you create. Calling Resource#create without using the factory lookup will result in an instance without a reference to the application's container and you will have to manually setup the relationships object prior to adding a relationship.

Sets the relationships data, used after the promise proxy resolves by toOne and toMany helpers

Sets all payload properties on the resource and resets private _attributes used for changed/previous tracking

Initializer for the model factories, registers option to not initialize

Removes resource identifier object of the relationship data. Also, sets the content of the related (computed property's) proxy object to null.

• For to-one relations the (resource linkage) data is set to null.
• For to-many relations the resource identifier object is removed from the resource Linkage data array.

See:

• http://jsonapi.org/format/#document-resource-object-linkage
• http://jsonapi.org/format/#document-resource-identifier-objects

Rollback changes to attributes and relationships

Revert to previous attributes

Revert to previous relationships

Helper to setup a has many relationship to another resource

let Author = Resource.extend({
  type: 'authors',
  name: attr(),
  posts: toMany('posts')
});

Or, with an optional type to use instead of the resource's service

let Person = Resource.extend({
  type: 'people',
  name: attr()
});

let Supervisor = Person.extend({
  type: 'supervisors',
  directReports: toMany({ resource: 'employees', type: 'people' })
});

Helper to setup a has one relationship to another resource

let Employee = Person.extend({
  type: 'employees',
  supervisor: toOne('supervisor')
});

Or, with an optional type to use instead of the resource's service

let Person = Resource.extend({
  type: 'people',
  name: attr()
});

let Employee = Person.extend({
  type: 'employees',
  supervisor: toOne({ resource: 'supervisor', type: 'people' })
});

Custom toString method used for clarity that the instance is a JSON API Resource kind of object