I had fun publishing my previous npm library, so I figured why not contribute another one to the open source world. Honesty, I’m not sure if this is a good thing, or just a bit of vanity, because the whole “library” is less than 100 lines of code. But I wrote it because it helped me, so maybe it will help somebody else. If you try it out, do please let me know if you run into an issue.
Ok, to business:
Extended Angular Firestore
Lightweight extension of Angular Firestore. Provides a more intuitive API. Create, Update, Insert-or-Update (Upsert), Check for Existence, Download Once, Download and listen for changes.
The goal of the API is to help the programmer manage Observable Subscriptions, so you only ask for exactly what you want. You can either ask to download a document or a collection exactly once, in which case you get back a Promise that resolves to the value of the document you are requesting. Or you can listen to a document or a collection, in which case you get back an Observable you can subscribe to (and might have to unsubscribe from). This structure has helped me avoid annoying double-request errors where I failed to unsubscribe from a stream I hadn’t realized I was still subscribed to.
This package also handles existence/nonexistence gracefully, which has been a weakness of both Firebase and Firestore in the past. To create or modify a document, simply use the Upsert method, which does the existence checking for you.
Finally, the API extension is lightweight – about 100 lines of TypeScript and three RXJS operators (which AngularFire may already need).