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:

Request	Description
POST /<resourceType> with JSON payload	Create Resource
PUT /<resourceType>/<resourceId> with JSON payload	Overwrite Resource
GET /<resourceType>/<resourceId>	Retrieve Resource

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.

parameter	description
data.dir	The location of the data in relation to your project root (default: 'data').

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

parameter	description
static.dir	The location of the files in relation to your project root (default: 'public').

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.

function	description
get(type, filter)	Retrieve a certain type of data that matches the given filter. type is a string. filter is either a resourceId string or an object that matches the specificiations of a mongodb query
post(type, data)	Store the provided data as the given type. type is a string. data is a JSON document
put(type, id, data)	Overwrite the stored data of the given type and id with the provided data. type is a string. id is a resourceId string. data is a JSON document.

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.