The Tcl package firebase allows writing to/reading from a Google Firebase
database.  

The firebase package requires the identifying project name of an existing
Firebase database, or the unique API key of the database, both available from
the Google Firebase web console interface.

For administrative access, a valid secret key string generated by Google for the
database is required.  The firebase package can generate an ID token in JWT 
format using this string; the token can be used for authentication for read and
write operations.

For client user access, the firebase package can create email/password accounts
for a database, and retrieve individual ID tokens for clients using the unique 
Google-generated API key of the database (the API key is different from the 
administrator secret key string). A user can specify an email/password using the
getToken command,  the command's code will check if an account exists with these
credentials and create an account if it doesn't, then return a valid JWT token 
for authorization. 

The firebase package can also be used to received streaming notification events
of database changes using Firebase's EventSource API.  A user can specify a
procedure which will be called in the background to receive each event's data
as events arrive from the Firebase site.

Administrator example:


% package require firebase
% set token [firebase::token $secret_string]
% firebase::put $db $token {{"a":1, "b":2}} test
% firebase::get $db $token
        {"test":{"a":1,"b":2}}


User example:

% set token [firebase::getToken [email protected] mypass $apikey]
% firebase::put $db $token {{"a":1, "b":2}} test
% firebase::delete $db $token {}
% firebase::get $db $token
        null


Event streaming example:

% set token [firebase::getToken [email protected] mypass $apikey]
% firebase::eventStream $db $token
        event: put
        data: {"path":"/","data":"test0"}


Procedures:

firebase::token secret ?uid?

generate a JWT-format token for authentication.  Optionally specify a uid to
restrict read/write access via security rules added to database.


firebase::get db token ?node?

get contents of entire database tree, or optionally contents of specified
subtree starting at node.  Returns: database contents in Tcl dict format.


firebase::put db token data ?node?

write data in JSON format to database, optionally at specified subtree node in 
the database.  Overwrites existing data.


firebase::push db token data ?node?

use Firebase "push" function to write JSON data to database without overwriting
existing data.  Google Firebase automatically generates a unique node name and 
inserts the data under that name.  Returns: unique node name generated by Google.


firebase::update db token data ?node?

change database values only of keys specified in JSON data, without overwriting
entire tree or subtree.


firebase::delete db token node

delete specified node in database tree.


firebase::signup email password apikey

if email/password authentication is enabled for the database corresponding to
the API key, create a new user account.  Returns: account state values 
(including authentication token) in key/value format as returned by Google, as a
Tcl dict.


firebase::login email password apikey

logs in to existing user account for the database corresponding to the API key.
Returns: account state values (including authentication token) in key/value 
format as returned by Google, as a Tcl dict.


firebase::getToken email password apikey

convenience function; tries to log in to account with given email and password,
if account doesn't exist the account is created.  Returns: authentication token
in JWT format for use with database read/write procedures.


firebase::eventStream db token eventproc timeout node

sets up streaming reception of events containing updates of the value of the
specified database node.  The argument "eventproc" is the name of a procedure
which will be called every time an event arrives, and passed a single argument
containing the contents of the event.


firebase::eventProc output

default callback procedure used by eventStream procedure.  Simply echoes event
data to standard output.