Package Exports

flamebase-database-node

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (flamebase-database-node) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🔥 flamebase-database-node

Real time JSON database (server node).

Usage

Import library:

var FlamebaseDatabase = require("flamebase-database-node");

Define database and reference to instance as JSON object:

var database    = "chats";      // database's name
var path        = "groupA";    // path to JSON reference
var FD          = new FlamebaseDatabase(database, "/" + path);
FD.syncFromDatabase();          // first load

Now FD.ref is groupA JSON object.

Do some work and sync: This JSON reference (groupA) contains this information:

{
    "people": {
        "john_travolta@ddd.com": {
            "name": "John Travolta",
            "token": "AsDadfsdfsDFCGsdfgEgWEcgcEgcwEgWegwEgeGWHTrydhdfsDFCGsdfgEgWEcgcEgcwEgWegwEgrty",
            "os": "android"
        },
        "donal_duck@aaa.com": {
            "name": "Donal Duck",
            "token": "DSfgsfgSgrtuyjYuIKyUyjRtyFytrydhdfsDFCGsdfgEgWEcgcEfgSgrtuyjYuIgcwEgWegwEgrty",
            "os": "android"
        }
    },
    "messages": {
        "1495171941114": {
            "author": "john_travolta@ddd.com",
            "text": "Message 1"
        },
        "1495171941127": {
            "author": "donal_duck@aaa.com",
            "text": "Message 2"
        },
        "1495171941159": {
            "author": "john_travolta@ddd.com",
            "text": "Message 3"
        },
        "1495171941327": {
            "author": "donal_duck@aaa.com",
            "text": "Message 4"
        }
    }
}

For insert new messages on this conversation compose a new message JSON object:

var message = {};
message.author = "john_travolta@ddd.com";
message.text = "Message 5";

var messageId = new Date().getTime().toString();
 
FD.ref.messages[messageId] = message;

FD.syncToDatabase();

At this point we have a JSON reference synchronized with our JSON database. Define some configuration properties to keep devices up to date when JSON reference changes.

var config = {};

/** 
* server API key for firebase cloud messaging
*/
config.APIKey = function() {
    return "GsdfgSVDfvsdAwejhFDGhbdASD"; // server key - FCM
};

/** 
* all device objects must have token and os info in order
* to slice big JSON changes for android or ios push notifications
*/
config.devices = function() {
    var devices = [];
    var keys = Object.keys(FD.ref.people);
    for (var i = 0; i < people.length; i++) {
        var person = FD.ref.people[keys[i]];
        
        var device = {};
        device.token = person.token;
        device.os = person.os;
        
        devices.push(device);
    }
    return devices;
};

/** 
* tag that informs android/ios client which action is being called
*/
config.tag = function() {
    return path + "_sync"; // groupA_sync
};

/**
* custom id for client database (used as primary key)
*/
config.referenceId = function() {
    return path; // groupA
};

/**
* custom notification to send when database reference changes.
* return null if not needed
*/
config.notification = function() {
    return {
        type: path + "_type",           // notification type
        name: "Database changed",       // name or text message
        image: "http://..."             // image url to show on left notification icon
    }
};

FD.setSyncConfig(config);

Enable debug logs:

FD.debug(true);