Added Chat example

Author: agentphantom

auth/README.md

@@ -201,10 +201,12 @@ Note that not all providers return the same information, for example Twitter doe
 
 Once you have the profile information you might want to save it on an Object that can be globally accessed, you will need it when performing Auth requests against Firebase Database and Firebase Storage.
 
+The `idToken` you receive from this response doesn't work with `auth` requests. You must exchange it for a new one using the next method.
+
 ## Refreshing the idToken
 
 By default the `idToken` has an expiration time of 60 minutes, you can reset its expiration by requesting a fresh one.
-To refresh an `idToken` you will only need to provide the previous one and specify the `grant_type` as `"authorization_code`.
+To refresh an `idToken` you will only need to provide the previous one and specify the `grant_type` as `"authorization_code"`.
 
 ```actionscript
 private function refreshToken(idToken:String):void
@@ -238,6 +240,19 @@ private function errorHandler(event:flash.events.IOErrorEvent):void
 }
 ``` 
 
+A successful response will look like the following JSON structure:
+
+```json
+{
+    "access_token": "<A long String>",
+    "expires_in": "3600",
+    "token_type": "Bearer",
+    "refresh_token": "<A long String>",
+    "id_token": "<A long String>",
+    "user_id": "ZJ7ud0CEpHYPF6QFWRGTe1U1Gvy2",
+    "project_id": "545203846422"
+}
+```
+
 Once you have got the `access_token` you are ready to continue performing secure operations against the Firebase Database and Firebase Storage.
 
-This method applies to both Federated and non Fedarated logins.

auth/email/README.md

@@ -5,7 +5,7 @@ Firebase provides 2 options when you require a way for your users to log in into
 * Email/Password Auth
 * Anonymous Auth
 
-Firebase also uses the Google Identity Toolkit to achieve this.
+Email and Anonymous Auth also uses the Google Identity Toolkit to achieve this.
 
 ## Getting Started
 
@@ -78,7 +78,7 @@ The user will be automatically registered in the Auth section from your Firebase
 
 For an Anonymous approach you don't need to specify anything in the request body. You will still get a response similar to the above just without an Email Address.
 
-Make sure to save this response inside the app so you can use it later to perform Auth requests and account managing.
+The `idToken` received from this response does work for `auth` requests.
 
 ## Verifying Credentials (Sign In)
 
@@ -125,6 +125,8 @@ A successful response will look like the following JSON structure:
 
 Note that failing to enter the correct password 3 times in a row will block the IP for future login attempts for a while.
 
+The `idToken` received from this response doesn't work for `auth` requests. You must refresh the `idToken` to get a functional one (see bottom of this guide).
+
 ## Password Reset
 
 To reset a password you only require to provide 2 parameters:
@@ -219,7 +221,7 @@ A successful response will look like the following JSON structure:
 
 An email with instructions will be sent to the desired email address. You can customize the template of emails in the Auth section from the Firebase console.
 
-## Get Account info
+## Get Account Info
 
 This method is used for retrieving the logged in user information, very useful to check if a user has confirmed their Email Address.
 
@@ -382,4 +384,55 @@ A successful response will look like the following JSON structure:
 {
     "kind": "identitytoolkit#DeleteAccountResponse"
 }
+```
+
+## Refreshing the idToken
+
+By default the `idToken` has an expiration time of 60 minutes, you can reset its expiration by requesting a fresh one.
+To refresh an `idToken` you will only need to provide the previous one and specify the `grant_type` as `"authorization_code"`.
+
+```actionscript
+private function refreshToken(idToken:String):void
+{
+	var header:URLRequestHeader = new URLRequestHeader("Content-Type", "application/json");
+			
+	var myObject:Object = new Object();
+	myObject.grant_type = "authorization_code";
+	myObject.code = idToken;			
+			
+	var request:URLRequest = new URLRequest("https://securetoken.googleapis.com/v1/token?key="+FIREBASE_API_KEY);
+	request.method = URLRequestMethod.POST;
+	request.data = JSON.stringify(myObject);
+	request.requestHeaders.push(header);
+			
+	var loader:URLLoader = new URLLoader();
+	loader.addEventListener(flash.events.Event.COMPLETE, refreshTokenLoaded);
+	loader.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
+	loader.load(request);	
+}
+		
+private function refreshTokenLoaded(event:flash.events.Event):void
+{
+    var rawData:Object = JSON.parse(event.currentTarget.data);
+    var newIdToken:String = rawData.access_token;
+}
+
+private function errorHandler(event:flash.events.IOErrorEvent):void
+{
+	trace(event.currentTarget.data);
+}
+``` 
+
+A successful response will look like the following JSON structure:
+
+```json
+{
+    "access_token": "<A long String>",
+    "expires_in": "3600",
+    "token_type": "Bearer",
+    "refresh_token": "<A long String>",
+    "id_token": "<A long String>",
+    "user_id": "ZJ7ud0CEpHYPF6QFWRGTe1U1Gvy2",
+    "project_id": "545203846422"
+}
 ```

database/README.md

@@ -4,8 +4,6 @@ Firebase offers a very flexible and secure way to save text-based data.
 
 This guide will show some of the most common scenarios and it will explain how to use Rules for your database. It is also written from an ActionScript and SQL perspective.
 
-A simple `CRUD` [example](./examples) has been provided for your convenience, it only requires a recent version of `Apache Flex` to compile.
-
 ## Understanding the Data
 
 The data saved in the Firebase database is structured like a tree. Each 'branch' can have its own branches and those sub branches can have their own sub branches.
@@ -358,6 +356,6 @@ private function journalLoaded(event:flash.events.Event):void
 }
 ```
 
-The `localId` and `auth` values can be obtained after a successful Sign In or Sign Up request.
+The `localId` and `auth` values can be obtained after a successful operation with the `Firebase Auth` service.
 
 For more information on these values you can read the [Firebase Auth guide](./../auth/).

auth/examples/EmailExample.mxml renamed to examples/EmailExample.mxml

@@ -0,0 +1,45 @@
+# Examples
+
+In this folder you will find several examples on how to use the Firebase services with ActionScript 3.
+
+It is strongly recommended to use recent versions of `Adobe AIR` and `Apache Flex`.
+
+## SimpleChat.mxml
+
+An Apache Flex example that demonstrates how to use the Firebase Database with realtime data and Email auth. This project makes use of the `Responses.as` file that can be found in the [utils folder](./../utils).
+
+You will require to enable the `Email` provider for your project, you will also require the following rules in your project:
+
+```json
+{
+    "rules": {
+        "messages": {
+            ".read": "auth != null",
+            ".write": "auth != null"
+        }
+    }
+}
+```
+
+## SimpleCRUD.mxml
+
+An Apache Flex example that demonstrates how to use the Firebase Database with non realtime data. You only require the following rules in your project:
+
+```json
+{
+    "rules": {
+        "journal": {
+            ".read": "true",
+            ".write": "true"
+        }
+    }
+}
+```
+
+## EmailExample.mxml
+
+An Apache Flex example that demonstrates how to perform most operations from the Email Auth service, you will only require to provide your Firebase API Key.
+
+## FederatedExample.mxml
+
+An Apache Flex example that demonstrates how to perform log-in using Google, Twitter and Facebook providers within the same app, you will only require to provide your Firebase API Key.