Scrapi

Data manager with a flexible API. A popup backend (nobackend, baas) that compliments your code or stands alone.

Scrapi can be used to setup a simple CRUD backend server with a REST interface, but also includes an internal client that provides your business logic with easy access to your data.

npm install scrapi

Usage

Basic Google Auth protected CRUD backend

Allows:

var Scrapi = require('scrapi');
 
var config = {
    auth: {
        providers: [
            'google'
        ]
    }
};
 
var scrapi = new Scrapi(config);
 
scrapi.start(function(data) {
    // REST server started
});

Google Auth protected CRUD backend with custom endpoints and logic

var Scrapi = require('scrapi');
 
var config = {
    auth: {
        providers: [
            'google'
        ]
    }
};
 
var scrapi = new Scrapi(config);
 
// Get the client for internal use
var scrapiClient = scrapi.getClient();
 
// Create a custom REST endpoint to trigger custom logic
// Will create:
// POST /users/<userId>/congratulate
scrapi.addCommand('users', 'congratulate', function(req, res) {
    // do custom logic to congratulate user
});
 
// Start the REST server after all custom endpoints have been added.
scrapi.start(function(data) {
    // REST server started
});

Configuration

auth - Configures how data access should be authorized. Only Google auth is supported (shown below) (default: disabled).

data - Describes data should be persisted. Currently, only supports an embedded noSQL database.

static - Configure how your site's static files should be served.

Here is an example config:

var config = {
    auth: {
        providers: [
            'google'
        ]
    },
    data: {
        dir: 'db'
    },
    static: {
        dir: 'assets'
    }
};

Internal client

The internal client provides your app with access to your data, ensuring changes will notify all interested clients.

The internal client contains functions that resemble the GET, POST, and PUT REST methods.

These functions each return a Promise. The get() and post() function Promises resolve to the JSON document requested or added. The put() function Promise resolves to an object with parameters matching the put() args.