firebase-thermite

What is it?

firebase-thermite is a library of RxJS observables for Firebase.

Why might you need it?

You might need it if you want to use RxJS observables and the official Angular library for Firebase - AngularFire2 - does not suit your requirements.

How does it differ from AngularFire2?

• It does not have a dependency on Angular.
• It has a type information-only dependency on firebase, so it can be used with firebase and with firebase-admin. ^*
• Its database observables emit appropriately typed values - rather than values typed as any.
• Its database observables support value selectors.
• Its database list observables support key selectors.
• It includes database observables that emit loaded, added, changed and removed events.
• It does not implement mutation methods on database observables - use the ref itself, instead.
• It does not implement declarative queries that contain Subject components - use a Subject that emits a declarative query and use toQuery and create an observable within a switchMap, instead.
• It includes an infinite list database observable.
• It includes a map database observable.
• The Angular modules are split into a separate library: firebase-thermite-ng

^* Actually, this is no longer the case. In recent releases, the typings in firebase and firebase-admin have diverged. And adding some preprocessing to account for the differences (similar to what's in firebase-nightlight) is on my TODO list.

Usage

At the moment, the tests will have to serve as the usage documentation.

Testing

To run the tests, you will need to provide several environment variables via a .env file. See constants-spec.ts and env-cmd - which is used to include the environment variables in the bundle.