Ember Data Adapter for parse-server

An Ember Data plugin built to use the Parse REST API. This is a full Ember implementation against the Parse REST API without the use of the Parse JavaScript SDK.

If you are not familiarized with the new open source project parse-server, you should visit the project page first.

Features

EmberParseAdapter.Serializer

• Provides the translation of objectId to id for identity mapping.
• Provides encoding of hasMany associations to arrays of Parse Pointer objects.

EmberParseAdapter.Adapter

• Implements the persistence layer to Parse by extending the Ember Data REST Adapter.
• Provides a sessionToken property which can set a session token.

EmberParseAdapter.ParseUser

Is stored at the special user endpoint at parse-server.

• Signup
• Login
• Logout
• Request password reset
• Request current user

EmberParseAdapter.Transforms

• Provides transforms for date, file and geo types at parse-server.

Get started

You'll need to use a Parse.com account, or to run parse-server on your own. After this you will have to provide:

• The url of your parse-server (is "https://api.parse.com" on Parse.com)
• The URL prefix of your Parse API (is "1" on Parse.com)
• The ID of your application
• The REST API Key of your application (only if you use a Parse.com account)

You will need these to configure the ParseAdapter via entries in the config/environment.js file:

var ENV = {
  ...

  APP: {
    parseUrl: '<THE URL OF THE PARSE SERVER HERE>',
    parseNamespace: '<THE URL PREFIX OF THE API HERE>',
    applicationId: '<YOUR APP ID HERE>',
    restApiId: '<YOUR REST API KEY HERE>' // (only if you use a Parse.com account)
  }
};

Any model using this adapter will be stored on Parse. Create models as you would normally:

App.Post = DS.Model.extend({
  // Attributes can use normal transforms
  title: DS.attr('string'),
  body: DS.attr('string'),
  rate: DS.attr('number'),
  // Or there are special transforms for some data-types like files
  avatar: DS.attr('parse-file'),
  // There is a parse-date transform, but sometimes dates are just strings
  updatedAt: DS.attr('parse-date'),
  // ALWAYS refer to relationships as async, for now.
  user: DS.belongsTo('parse-user', {async: true})
});

Security Warning

Before publishing your app you should disable REST Push. Parse apps are created with this feature enabled by default. If this feature is enabled anyone with your Application ID and REST API Key will be able to send push notifications to your user's devices. Anyone using your app has access your Application ID and REST API Key.

To disable REST Push:

• Login to your Parse account.
• Click on your application.
• Go to Settings > Push.
• And disable REST Push.
• It should look like the image below.

Installation

• git clone this repository
• npm install
• bower install

Running

• ember server
• Visit your app at http://localhost:4200.

Running Tests

• npm test (Runs ember try:testall to test your addon against multiple Ember versions)
• ember test
• ember test --server

Building

• ember build

For more information on using ember-cli, visit http://www.ember-cli.com/.