katowulf

{
  "chat": {
     // the list of chats may not be listed (no .read permissions here)
     
     // a chat conversation
     "$key": {
         
         // if the chat hasn't been created yet, we allow read so there is a way 
         // to check this and create it; if it already exists, then authenticated 
         // user (specified by auth.id) must be in $key/users

katowulf

{
  "firestore": {
    "rules": "firestore.rules",
    "indexes": "firestore.indexes.json"
  },
  "emulators": {
    "firestore": {
      "port": 8080
    }
  }

katowulf

/**
 *  This little helper is called instead of on() to monitor data and handle auth expiration
 *  It assumes that you monitor authentication state and re-auth if
 *  your auth token expires. It also doesn't help with any transactions, set ops, or
 *  other writes which could be in progress when authentication is lost--those will
 *  explode in glorious flashes of failure
 *
 *  To support IE8, you will want these polyfills:
 *  forEach: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach#Polyfill
 *  indexOf: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/indexOf#Polyfill

katowulf

/*
 * Promise wrapper for Firebase
 *
 * Requires jQuery and underscore.js
 *************************************/
(function ($) {
   "use strict";
   var undefined;
   var FIREBASE_URL = 'https://YOURINSTANCE.firebaseio.com';

katowulf

var Firebase = require("./firebase-node.js");

function Queue(ref) {
  this._ref = ref;
}

Queue.prototype.pop = function(cb) {
  this._ref.startAt().limit(1).once("child_added", this._pop.bind(this, cb));
}

katowulf

// assumes you add a timestamp field to each record (see Firebase.ServerValue.TIMESTAMP)
// pros: fast and done server-side (less bandwidth, faster response), simple
// cons: a few bytes on each record for the timestamp
var ref = new Firebase(...);
ref.orderByChild('timestamp').startAt(Date.now()).on('child_added', function(snapshot) {
  console.log('new record', snap.key());
});

katowulf

/******* Android **********/
// See https://firebase.google.com/docs/reference/android/com/google/firebase/firestore/FirebaseFirestore.html#setLoggingEnabled(boolean)
FirebaseFirestore.setLoggingEnabled(true);

/******* Server-side Java **********/
/** 
  See https://medium.com/@hiranya911/logging-in-java-libraries-for-firebase-and-google-cloud-platform-f8742493b73f
  1) Add the slf4j-simple binding to the application classpath
  2) Set the -Dorg.slf4j.simpleLogger.defaultLogLevel=debug system property
**/

katowulf

/***************************************************
 * Simple and elegant, no code complexity
 * Disadvantages: Requires warming all data into server memory (could take a long time for MBs of data or millions of records)
 * (This disadvantage should go away as we add optimizations to the core product)
 ***************************************************/
 
var fb = firebase.database.ref();

/**
 * @param {string} emailAddress

katowulf

import * as firebase from "firebase/app";
import 'firebase/firestore';
import config from './config';

firebase.initializeApp(config);

const data = {
  string: 'foo',
  integer: 23,
  boolean: false,

katowulf

// docs/{docId}/users is an array of user ids allowed to access the doc

match /docs/{docId} {
  allow read if request.auth.uid in getData('docs/$(docId)').users;
}

/**
 * Shortcut to simplify pathing
 */
function getPath(childPath) {