first working or at least useful verion for rtdb

This commit is contained in:
Peter Svensson
2019-06-09 17:00:41 +02:00
parent e8067d6b08
commit 692929400e
12 changed files with 529 additions and 0 deletions

View File

@ -1,2 +1,55 @@
# node-red-contrib-firebase-admin
A node-red module that wraps the server-side admin SDK of firebase, firestore, et.c.
# Overview
The main difference of this module and all other firebase/store modules for node-red is
that it takes a service account credential token as configuration.
This means that the nodes can run outside of the normal security rules, in admin mode, which is usefule when running on the back-end.
# Realtime Database (rtdb) Nodes
## rtdb-get
Get data from a path in the rtdb database
input: {payload: {path: 'foo/bar'}}
output: <whatever data was at the path 'foo/bar' in the rtdb database>
## rtdb-set
Set data at a path in the rtdb database. Use 'on' snapshot so will fire everytime the data at the path changes and so drive flow executin from that point.
input: {payload: {path: 'foo/bar'}, {some: 'object', foo: 17}}
## rtdb-query
Set up a reactive wuery for a path in the rtdb database.
input: {payload: {path: 'foo/bar', queries:[], on: 'value}}
on: 'value' (can also be 'child_added', 'child_removed', 'child_changed', 'child_moved').
If an 'on' property is missing, on: 'value' is assumed as default
Where each query is an object that can look like either of the following examples;
- {startAt: 'foo'}
- {endAt: 'bar'}
- {equalTo: 'quux'}
- {orderBy: 'child', value: 'height'} (can also be 'key' or 'value)
- {limitTo: 'last', value: 3} (can also be 'first')
output: [an array of results for the query]
# Firestore nodes
TBD
# Storage nodes
TBD
# Auth nodes
TBD

28
firebase-config.html Normal file
View File

@ -0,0 +1,28 @@
<script type="text/javascript">
RED.nodes.registerType('firebase-config',{
category: 'config',
defaults: {
name: {value:"", required:true},
cred: {value:"", required:true},
dburl: {value:"", required:true},
},
label: function() {
return this.name;
}
});
</script>
<script type="text/x-red" data-template-name="firebase-config">
<div class="form-row">
<label for="node-config-input-name"><i class="icon-bookmark"></i> Name</label>
<input type="text" id="node-config-input-name">
</div>
<div class="form-row">
<label for="node-config-input-cred"><i class="icon-bookmark"></i> Firebase Service Account Credentials</label>
<input type="text" id="node-config-input-cred">
</div>
<div class="form-row">
<label for="node-config-input-dburl"><i class="icon-bookmark"></i> Firebase Database URL</label>
<input type="text" id="node-config-input-dburl">
</div>
</script>

23
firebase-config.js Normal file
View File

@ -0,0 +1,23 @@
const _admin = require('firebase-admin')
let init = false
module.exports = function(RED) {
function FirebaseConfigNode(n) {
RED.nodes.createNode(this,n);
this.cred = n.cred
this.dburl = n.dburl
this.admin = _admin
if(!init){
console.log('setting admin....')
init = true
this.credentials = JSON.parse(this.cred);
this.dburl = this.dburl
console.log('*** parsed firebase credentials: '+this.credentials.type+', project-id: '+this.credentials.project_id)
_admin.initializeApp({
credential: _admin.credential.cert(this.credentials),
databaseURL: this.dburl
});
}
}
RED.nodes.registerType("firebase-config", FirebaseConfigNode);
}

31
package.json Normal file
View File

@ -0,0 +1,31 @@
{
"name": "node-red-contrib-firebase-admin",
"version": "1.0.0",
"description": "A node-red module that wraps the server-side admin SDK of firebase, firestore, et.c.",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"repository": {
"type": "git",
"url": "git+https://github.com/psvensson/node-red-contrib-firebase-admin.git"
},
"author": "",
"license": "MIT",
"bugs": {
"url": "https://github.com/psvensson/node-red-contrib-firebase-admin/issues"
},
"homepage": "https://github.com/psvensson/node-red-contrib-firebase-admin#readme",
"node-red": {
"nodes": {
"rtdb-set": "rtdb-set.js",
"rtdb-push": "rtdb-push.js",
"rtdb-get": "rtdb-get.js",
"rtdb-query": "rtdb-query.js",
"firebase-config": "firebase-config.js"
}
},
"dependencies": {
"firebase-admin": "^8.0.0"
}
}

50
rtdb-get.html Normal file
View File

@ -0,0 +1,50 @@
<script type="text/javascript">
RED.nodes.registerType('rtdb-get',{
category: 'function',
color: '#a6bbcf',
defaults: {
name: {value:""},
cred: {value: "", type: 'firebase-config'}
},
inputs:1,
outputs:1,
icon: "firebase-admin-icon.png",
label: function() {
return this.name||"rtdb-get";
},
oneditsave: function() {
let type = $('#apitype-select').val()
console.log('type is set to '+type)
},
oneditprepare: function() {
$('#apitype-select').change(function () {
$("#node-input-apitype").val($(this).find('option:selected').val())
});
$("#apitype-select").val($("#node-input-apitype").val())
$('#apitype-select').trigger('change');
}
});
</script>
<script type="text/x-red" data-template-name="rtdb-get">
<div class="form-row">
<label for="node-input-name"><i class="icon-tag"></i> Name</label>
<input type="text" id="node-input-name" placeholder="Name">
</div>
<div class="form-row">
<label for="node-input-cred"><i class="icon-tag"></i> Credentials</label>
<input type="text" id="node-input-cred" placeholder="Name">
</div>
</script>
<script type="text/x-red" data-help-name="rtdb-get">
<p>A node that wraps the rtdb-get SDK</p>
</script>

39
rtdb-get.js Normal file
View File

@ -0,0 +1,39 @@
let oldpath
module.exports = function(RED) {
function FirebaseAdmin(config) {
RED.nodes.createNode(this, config);
var node = this;
console.log('config is..')
console.dir(config)
if(config.cred){
let c = RED.nodes.getNode(config.cred)
this.admin = c.admin
}
const cb = (res)=>{
console.log('firebase get result '+res)
console.dir(res)
let val = res.val()
console.log('val='+val)
node.send({payload:val})
}
node.on('input', function(msg) {
if(msg && msg.payload){
const path = msg.payload.path
if(oldpath){
this.admin.database().ref(oldpath).off('value', cb)
}
this.admin.database().ref(path).on('value', cb)
oldpath = path
}
}.bind(this));
}
RED.nodes.registerType("rtdb-get", FirebaseAdmin);
}

50
rtdb-push.html Normal file
View File

@ -0,0 +1,50 @@
<script type="text/javascript">
RED.nodes.registerType('rtdb-push',{
category: 'function',
color: '#a6bbcf',
defaults: {
name: {value:""},
cred: {value: "", type: 'firebase-config'}
},
inputs:1,
outputs:0,
icon: "firebase-admin-icon.png",
label: function() {
return this.name||"rtdb-push";
},
oneditsave: function() {
let type = $('#apitype-select').val()
console.log('type is set to '+type)
},
oneditprepare: function() {
$('#apitype-select').change(function () {
$("#node-input-apitype").val($(this).find('option:selected').val())
});
$("#apitype-select").val($("#node-input-apitype").val())
$('#apitype-select').trigger('change');
}
});
</script>
<script type="text/x-red" data-template-name="rtdb-push">
<div class="form-row">
<label for="node-input-name"><i class="icon-tag"></i> Name</label>
<input type="text" id="node-input-name" placeholder="Name">
</div>
<div class="form-row">
<label for="node-input-cred"><i class="icon-tag"></i> Credentials</label>
<input type="text" id="node-input-cred" placeholder="Name">
</div>
</script>
<script type="text/x-red" data-help-name="rtdb-push">
<p>A node that wraps the rtdb-push SDK</p>
</script>

32
rtdb-push.js Normal file
View File

@ -0,0 +1,32 @@
module.exports = function(RED) {
function FirebaseAdmin(config) {
RED.nodes.createNode(this, config);
var node = this;
console.log('config is..')
console.dir(config)
if(config.cred){
let c = RED.nodes.getNode(config.cred)
this.admin = c.admin
}
node.on('input', function(msg) {
if(msg && msg.payload){
console.log('rtdb-push got input')
console.dir(msg)
const path = msg.payload.path
const obj = msg.payload.obj
console.log('storing '+obj+' at rtdb path '+path)
this.admin.database().ref(path).push(obj).then((res)=>{
console.log('firebase set result '+res)
console.dir(res)
})
}
}.bind(this));
}
RED.nodes.registerType("rtdb-push", FirebaseAdmin);
}

50
rtdb-query.html Normal file
View File

@ -0,0 +1,50 @@
<script type="text/javascript">
RED.nodes.registerType('rtdb-query',{
category: 'function',
color: '#a6bbcf',
defaults: {
name: {value:""},
cred: {value: "", type: 'firebase-config'}
},
inputs:1,
outputs:1,
icon: "firebase-admin-icon.png",
label: function() {
return this.name||"rtdb-query";
},
oneditsave: function() {
let type = $('#apitype-select').val()
console.log('type is set to '+type)
},
oneditprepare: function() {
$('#apitype-select').change(function () {
$("#node-input-apitype").val($(this).find('option:selected').val())
});
$("#apitype-select").val($("#node-input-apitype").val())
$('#apitype-select').trigger('change');
}
});
</script>
<script type="text/x-red" data-template-name="rtdb-query">
<div class="form-row">
<label for="node-input-name"><i class="icon-tag"></i> Name</label>
<input type="text" id="node-input-name" placeholder="Name">
</div>
<div class="form-row">
<label for="node-input-cred"><i class="icon-tag"></i> Credentials</label>
<input type="text" id="node-input-cred" placeholder="Name">
</div>
</script>
<script type="text/x-red" data-help-name="rtdb-query">
<p>A node that wraps the rtdb-query SDK</p>
</script>

91
rtdb-query.js Normal file
View File

@ -0,0 +1,91 @@
let oldpath
let oldeventtype
module.exports = function(RED) {
function FirebaseAdmin(config) {
RED.nodes.createNode(this, config);
var node = this;
console.log('config is..')
console.dir(config)
if(config.cred){
let c = RED.nodes.getNode(config.cred)
this.admin = c.admin
}
const cb = (res)=>{
console.log('firebase get result '+res)
console.dir(res)
let val = res.val()
console.log('val='+val)
node.send({payload:val})
}
node.on('input', function(msg) {
if(msg && msg.payload){
const path = msg.payload.path
const eventtype = msg.payload.on || 'value'
if(oldpath){
this.admin.database().ref(oldpath).off(oldeventtype, cb)
}
let ref = this.admin.database().ref(path)
// Decorate with queries
if(msg.payload.queries && msg.payload.queries.length > 0){
console.log('found queries')
let ordered = false
msg.payload.queries.forEach((query)=>{
console.dir(query)
if(query.orderBy){
ordered = true
console.log('setting explicit orderBy')
if(query.orderBy === 'value'){
ref = ref.orderByValue()
} else if(query.orderBy === 'key'){
ref = ref.orderByKey()
} else if(query.orderBy === 'child'){
ref = ref.orderByChild(query.value)
}
}
if(query.startAt){
console.log('startAt '+query.startAt)
ref = ref.startAt(query.startAt)
}
if(query.endAt){
console.log('endAt '+query.endAt)
ref = ref.endAt(query.endAt)
}
if(query.equalTo){
console.log('equalTo '+query.equalTo)
ref = ref.equalTo(query.equalTo)
}
if(query.limitTo){
console.log('limitTo '+query.limitTo+' -> '+query.value)
if(query.limitTo === 'first'){
ref = ref.limitToFirst(query.value)
} else if(query.limitTo === 'last'){
ref = ref.limitToLast(query.value)
}
}
})
if(!ordered) {
console.log('setting implicit orderBy')
ref = ref.orderByValue()
}
}
console.log('finished rtdb query is')
console.dir(ref.queryParams_)
ref.on(eventtype, cb)
oldpath = path
oldeventtype = eventtype
}
}.bind(this));
}
RED.nodes.registerType("rtdb-query", FirebaseAdmin);
}

50
rtdb-set.html Normal file
View File

@ -0,0 +1,50 @@
<script type="text/javascript">
RED.nodes.registerType('rtdb-set',{
category: 'function',
color: '#a6bbcf',
defaults: {
name: {value:""},
cred: {value: "", type: 'firebase-config'}
},
inputs:1,
outputs:0,
icon: "firebase-admin-icon.png",
label: function() {
return this.name||"rtdb-set";
},
oneditsave: function() {
let type = $('#apitype-select').val()
console.log('type is set to '+type)
},
oneditprepare: function() {
$('#apitype-select').change(function () {
$("#node-input-apitype").val($(this).find('option:selected').val())
});
$("#apitype-select").val($("#node-input-apitype").val())
$('#apitype-select').trigger('change');
}
});
</script>
<script type="text/x-red" data-template-name="rtdb-set">
<div class="form-row">
<label for="node-input-name"><i class="icon-tag"></i> Name</label>
<input type="text" id="node-input-name" placeholder="Name">
</div>
<div class="form-row">
<label for="node-input-cred"><i class="icon-tag"></i> Credentials</label>
<input type="text" id="node-input-cred" placeholder="Name">
</div>
</script>
<script type="text/x-red" data-help-name="rtdb-set">
<p>A node that wraps the rtdb-set SDK</p>
</script>

32
rtdb-set.js Normal file
View File

@ -0,0 +1,32 @@
module.exports = function(RED) {
function FirebaseAdmin(config) {
RED.nodes.createNode(this, config);
var node = this;
console.log('config is..')
console.dir(config)
if(config.cred){
let c = RED.nodes.getNode(config.cred)
this.admin = c.admin
}
node.on('input', function(msg) {
if(msg && msg.payload){
console.log('rtdb-set got input')
console.dir(msg)
const path = msg.payload.path
const obj = msg.payload.obj
console.log('storing '+obj+' at rtdb path '+path)
this.admin.database().ref(path).set(obj).then((res)=>{
console.log('firebase set result '+res)
console.dir(res)
})
}
}.bind(this));
}
RED.nodes.registerType("rtdb-set", FirebaseAdmin);
}