refactor(db): WIP new database API

refactor(db): WIP new database API

Author: davideast

.DS_Store

@@ -9,3 +9,5 @@ npm-debug.log
 angularfire2-*.tgz
 *.ngfactory.ts
 *.ngsummary.json
+*.bak
+.DS_Store

.gitignore

@@ -2,10 +2,9 @@ language: node_js
 sudo: false
 node_js:
 - 'node'
-dist: precise
 
 addons:
-  firefox: latest
+  chrome: stable
   apt:
     sources:
       - ubuntu-toolchain-r-test
@@ -27,7 +26,7 @@ before_script:
 
 script:
   - npm run build
-  - ./node_modules/.bin/karma start --single-run --browsers Firefox --reporters mocha
+  - ./node_modules/.bin/karma start --single-run --browsers Chrome --reporters mocha
   # Run integration test to make sure our typings are correct for user-land.
   - node tools/run-typings-test.js
 

.travis.yml

@@ -1,24 +1,25 @@
 <p align="center">
-  <h1 align="center">AngularFire2</h1>
-  <p align="center">The official library for Firebase and Angular 2</p>
+  <h1 align="center">AngularFire</h1>
+  <p align="center">The official library for Firebase and Angular</p>
 </p>
 
 [![Build Status](https://travis-ci.org/angular/angularfire2.svg?branch=master)](https://travis-ci.org/angular/angularfire2) [![Join the chat at https://gitter.im/angular/angularfire2](https://badges.gitter.im/angular/angularfire2.svg)](https://gitter.im/angular/angularfire2?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
 Status: Release candidate
 
-## What is AngularFire2?
+## What is AngularFire?
 
-- **Observable based** - Use the power of rxjs, Angular 2, and Firebase.
-- **Realtime bindings** - Synchronize database collections as objects or lists.
-- **Authentication** - Monitor authentication state in realtime.
+- **Observable based** - Use the power of RxJS, Angular, and Firebase.
+- **Realtime bindings** - Synchronize data in reatime.
+- **Authentication** - Log users in with a variety of providers and monitor authentication state in realtime.
+- **ngrx friendly** - Integrate with ngrx using AngularFire's action based APIs.
 
 #### Quick links
 [Contributing](CONTRIBUTING.md)
 
 [Stackblitz Template](https://stackblitz.com/edit/angular-2ed5zx?) - Remember to set your Firebase configuration in `app/app.module.ts`.
 
-[Upgrading to v4.0? Check out our guide.](docs/version-4-upgrade.md)
+[Upgrading to v5.0? Check out our guide.](docs/version-5-upgrade.md)
 
 ## Install
 
@@ -30,7 +31,8 @@ npm install firebase angularfire2 --save
 
 ```ts
 import { Component } from '@angular/core';
-import { AngularFireDatabase, FirebaseListObservable } from 'angularfire2/database';
+import { AngularFireDatabase } from 'angularfire2/database';
+import { Observable } from 'rxjs/Observable';
 
 @Component({
   selector: 'project-name-app',
@@ -43,23 +45,29 @@ import { AngularFireDatabase, FirebaseListObservable } from 'angularfire2/databa
   `
 })
 export class MyApp {
-  items: FirebaseListObservable<any[]>;
+  items: Observable<any[]>;
   constructor(db: AngularFireDatabase) {
-    this.items = db.list('/items');
+    this.items = db.list('items').valueChanges();
   }
 }
 ```
 
 ## Developer Guide
-If you want to get started quickly on building with AngularFire2, check out our
-5 step developer guide that will teach you everything you need to know to be 
-productive with AngularFire2.
-
-1. [Installation & Setup](docs/1-install-and-setup.md)
-2. [Retrieving data as objects - FirebaseObjectObservable](docs/2-retrieving-data-as-objects.md)
-3. [Retrieving data as lists - FirebaseListObservable](docs/3-retrieving-data-as-lists.md)
-4. [Querying lists](docs/4-querying-lists.md)
-5. [User Authentication - FirebaseAuthentication](docs/5-user-authentication.md)
-6. [Using AngularFire2 with Ionic](docs/Auth-with-Ionic2.md)
-7. [Using AngularFire2 with Ionic and Angular 4](docs/Auth-with-Ionic3-Angular4.md)
-8. [Deploying AngularFire2 to FirebaseHosting](docs/7-deploying-angularfire-to-firebase.md)
+
+### Getting started
+- [Installation & Setup](docs/1-install-and-setup.md)
+
+### AngularFireDatabase
+- [Retrieving data as objects](docs/2-retrieving-data-as-objects.md)
+- [Retrieving data as lists](docs/3-retrieving-data-as-lists.md)
+- [Querying lists](docs/4-querying-lists.md)
+
+### AngularFireAuth
+- [User Authentication](docs/5-user-authentication.md)
+
+### Deploy to Firebase Hosting
+- [Deploying AngularFire to Firebase Hosting](docs/7-deploying-angularfire-to-firebase.md)
+
+### Ionic
+- [Using AngularFire with Ionic 2](docs/Auth-with-Ionic2.md)
+- [Using AngularFire with Ionic 3 and Angular 4](docs/Auth-with-Ionic3-Angular4.md)

README.md

@@ -1,35 +1,13 @@
 # 1. Installation and Setup
 
-> Getting started with AngularFire2 is easy with the [Angular CLI](https://github.com/angular/angular-cli). Follow the 10 steps below to get started. Don't worry, we're always working to make this shorter.
-
 > Using Ionic and the Ionic CLI? Check out these [specific instructions](6-angularfire-and-ionic-cli.md) for Ionic and their CLI.
 
 ### 0. Prerequisites
 
-Before you start installing AngularFire2, make sure you have latest version of angular-cli installed.
-To verify run the command `ng -v` and ensure you see `angular-cli: 1.x.x-beta.xx`. The lowest compatible version is `1.x.x-beta.14`.
-
-If not, you may need to do the following:
+AngularFire provides multiple module formats for different types of builds. The guide is based off the Angular CLI. It is possible to do a manual setup with Webpack or a SystemJS build as well.
 
 ```bash
-# if you have the wrong cli version only
-npm uninstall -g angular-cli
-npm uninstall -g @angular/cli
-npm cache clean
-
-# reinstall clean version
-npm install -g @angular/cli@latest
-```
-
-You need the Angular CLI, typings, and TypeScript.
-
-```bash
-npm install -g @angular/cli@latest
-# or install locally
-npm install @angular/cli --save-dev
-# make sure you have typings installed
-npm install -g typings
-npm install -g typescript
+npm install @angular/cli
 ```
 
 ### 1. Create a new project
@@ -50,13 +28,13 @@ open http://localhost:4200
 
 You should see a message that says *App works!*
 
-### 3. Install AngularFire 2 and Firebase
+### 3. Install AngularFire and Firebase
 
 ```bash
 npm install angularfire2 firebase --save
 ```
 
-Now that you have a new project setup, install AngularFire2 and Firebase from npm.
+Now that you have a new project setup, install AngularFire and Firebase from npm.
 
 ### 4. Add Firebase config to environments variable
 
@@ -79,6 +57,7 @@ export const environment = {
 ### 5. Setup @NgModule for the AngularFireModule
 
 Open `/src/app/app.module.ts`, inject the Firebase providers, and specify your Firebase configuration.
+
 This can be found in your project at [the Firebase Console](https://console.firebase.google.com):
 
 ```ts
@@ -177,17 +156,18 @@ In `/src/app/app.component.ts`:
 
 ```ts
 import { Component } from '@angular/core';
-import { AngularFireDatabase, FirebaseListObservable } from 'angularfire2/database';
+import { AngularFireDatabase } from 'angularfire2/database';
+import { Observable } from 'rxjs/Observable';
 
 @Component({
   selector: 'app-root',
   templateUrl: 'app.component.html',
   styleUrls: ['app.component.css']
 })
 export class AppComponent {
-  items: FirebaseListObservable<any[]>;
+  items: Observable<any[]>;
   constructor(db: AngularFireDatabase) {
-    this.items = db.list('/items');
+    this.items = db.list('items').valueChanges();
   }
 }
 ```
@@ -197,7 +177,7 @@ Open `/src/app/app.component.html`:
 ```html
 <ul>
   <li class="text" *ngFor="let item of items | async">
-    {{item.$value}}
+    {{ item | json }}
   </li>
 </ul>
 ```
@@ -214,33 +194,3 @@ And that's it! If it's totally *borked*, file an issue and let us know.
 
 ### [Next Step: Retrieving data as objects](2-retrieving-data-as-objects.md)
 
-### Troubleshooting
-
-#### 1. Cannot find namespace 'firebase'.
-
-If you run into this error while trying to invoke `ng serve`, open `src/tsconfig.json` and add the "types" array as follows:
-
-```json
-{
-  "compilerOptions": {
-    ...
-    "typeRoots": [
-      "../node_modules/@types"
-    ],
-
-    // ADD THIS
-    "types": [
-      "firebase"
-    ]
-  }
-}
-```
-
-#### 2. Cannot find name 'require' (This is just a temporary workaround for the Angular CLI).
-
-If you run into this error while trying to invoke `ng serve`, open `src/typings.d.ts` and add the following two entries as follows:
-
-```bash
-declare var require: any;
-declare var module: any;
-```