open-parse

Open Parse

Open Parse = Parse.com + JSON API + koa

The collection of middleware which provides flexible RESTful API for accessing to application data store and schemas, users and security management. Save your time to bootstrap new web and mobile projects.

Open Parse is open source BaaS (Backend as a Service). On the schema below that is "Data Proccessing / Management":

Out of the box Open Parse supports:

• bunyan-logger which could be connected to Logentries, Loggly, NewRelic and other cloud log management services just in a 15 seconds.

• MongoDB as default data provider. But you could implement custom data providers for any other databases (it takes ~20 min).

Built with love to Functional Principles and.. yes, koa.

Content

• How it works?
• Installation
• Basic usage
• FAQ
  • How to connect a Cloud Log Service?
• Inspiration
• Contribution
• Roadmap

How It Works?

Open Parse is incredibly simple. It's just a glue which is connecting 2 pieces:

• Middleware to get RESTful API end-point on your web server. It's implemented according to JSON API specification.
• Data Providers to work with any data storage (by default is MongoDB).

You can extend any of those points.

Installation

npm install --save open-parse

Basic Usage

The following example has been written with using promised-mongo and koa-router packages.

Setup the environment

import Router from 'koa-router';
import pmongo from 'promised-mongo';

const router = new Router();
const db = new pmongo('localhost/my-app');

const dataRequired = function *(next) {
  if (typeof this.request.body['data'] === 'object') {
    yield next;
  } else {
    this.throw(400, 'Request data is required');
  }
};

Bring up Users API

const users = {
  dataProvider: new UsersDataProvider({
    collection: db.collection('users')
  })
};
router.post('/users', dataRequired, handleUserSignUp(users));
router.get('/login', handleUserLogin(users));
router.post('/logout', handleUserLogout(users));
router.get('/users/me', handleUserFetch(users));

Bring up Classes API

In this example we're using a local data from JSON file.

const classes = {
  dataProvider: new ObjectsDataProvider({
    collection: db.collection('objects'),
    initialCache: require('./cached-objects.json')
  }),
};
router.post('/classes/:className', dataRequired, handleObjectCreate(classes));
router.get('/classes/:className', handleObjectsList(classes));
router.get('/classes/:className/:objectId', handleObjectFetch(classes));
router.patch('/classes/:className/:objectId', dataRequired, handleObjectUpdate(classes));
router.delete('/classes/:className/:objectId', handleObjectDelete(classes));

For ObjectsDataProvider an initial cache should be specified as a [className][objectId] hash object:

cached-objects.json

{ 
  "company": {
    "our": {
      "title": "Startup Makers",
      "about": "We are consulting and outsourcing a web-development with cutting-edge JavaScript technologies (ES6, Node.js, React, Redux, koa)"
    }
  }
}

Bring up Schemas API

const schemas = {
  dataProvider: new SchemasDataProvider({
    collection: db.collection('schemas')
  })
};
router.get('/schemas/:className', handleSchemaFetch(schemas));

Connect the router to your application

import koa from 'koa';
import cors from 'kcors';
import qs from 'koa-qs';
import bodyParser from 'koa-bodyparser';
import mount from 'koa-mount';

// Create the server instance
const app = koa();
app.use(cors());
qs(app);
app.use(bodyParser());

// ...paste your routes here...

// Connect API router
app.use(mount('/api', router));

// Go LIVE
app.listen(process.env['PORT'] || 3000);

Work with Open Parse API from the browser or mobile apps

For example how to implement login in your browser scripts when you have connected Open Parse:

const login = (email, password) => {
  const loginURL =
    '/api/login'
    + '?email=' + encodeURIComponent(email)
    + '&password=' + encodeURIComponent(password);
  fetch(loginURL, {
    headers: {
      'Accept': 'application/json',
    },
    credentials: 'same-origin'
  }).then((response) => response.json()).then((body) => {
    if (body['data']) {
      const userId = body['data']['id'];
      const userName = body['data']['attributes']['name'];
      console.log('Logged as user %s (%s)', userName, userId);
    } else {
      body['errors'].forEach(error =>
        console.error('Auth error: %s (%s)', error['title'], error['source']['parameter'])
      );
    }
  });
};

FAQ

How To Connect a Cloud Log Service?

It's really easy. Did you initialize a logger? If you didn't, let's do it right now:

import bunyan from 'bunyan';
import { LogentriesBunyanStream } from 'bunyan-logentries';

const logger = bunyan.createLogger({
  name: 'awesome-app',
  streams: {
    stream: new LogentriesBunyanStream({
      token: process.env['LOGENTRIES_TOKEN']
    }),
    level: 'debug',
    type: 'raw'
  }
});

Add just a one line to your code

const users = {
  dataProvider: new UsersDataProvider({
    collection: db.collection('users')
  }),
  logger // THIS LINE!
};
router.post('/users', dataRequired, handleUserSignUp(users));
router.get('/login', handleUserLogin(users));
router.post('/logout', handleUserLogout(users));
router.get('/users/me', handleUserFetch(users));

That's all. You will get a messages (about login, logout and fetching the data about users) in your Logentries account.

Inspiration

• Parse.com - Commercial Backend-as-a-Service platform
• BaasBox API - Java-based open source Backend-as-a-Service solution
• DeployD API - first generation open source BaaS platform
• Sails.js - first generation MVC framework for Node.js
• Reindex.io - Commercial BaaS platform with GraphQL API

Contribution

Are you ready to make the world better?

1. Fork this repo

2. Checkout your repo:

git clone [e-mail]:YourAccount/open-parse.git

3. Create your feature (or issue) branch:

git checkout -b my-new-feature

4. Commit your changes:

git commit -am 'Add some changes'

5. Push to the branch:

git push origin my-new-feature

6. Create new pull request

Thank you very much. Your support is greatly appreciated.

Roadmap

Version 0.2

• Support access control layer (ACL)
• Add real world example
• Improve the documentation and architecture schema
• Add 'Access-Control-Allow-Origin' header

Version 0.3

• Add Express middleware adapter
• Support jobs feature
• Support e-mail service

Version 0.4

• Add client SDK for JavaScript and React Native
• Support files feature

Version 0.5

• Support web hooks