enhancements and doc for #18 and #20

Author: EddyVerbruggen

README.md

@@ -91,6 +91,10 @@ This function will store a JSON object at path `<Firebase URL>/users/<Generated
           'number': 123
         }
       }
+  }).then(
+      function (result) {
+        console.log("created key: " + result.key);
+      }
   );
 ```
 
@@ -226,10 +230,10 @@ You can expect more login mechanisms to be added in the future.
     email: '[email protected]',
     password: 'firebase'
   }).then(
-      function (uid) {
+      function (result) {
         dialogs.alert({
           title: "User created",
-          message: "uid: " + uid,
+          message: "userid: " + result.key,
           okButtonText: "Nice!"
         })
       },

firebase.android.js

@@ -140,7 +140,9 @@ firebase.createUser = function (arg) {
       var valueResultHandler = new com.firebase.client.Firebase.ValueResultHandler({
         onSuccess: function (authData) {
           console.log("--- created: " + authData);
-          resolve(firebase.toJsObject(authData).uid);
+          resolve({
+            key: firebase.toJsObject(authData).uid
+          });
         },
         onError: function (firebaseError) {
           reject(firebaseError.getMessage());

firebase.d.ts

@@ -71,6 +71,20 @@ declare module "nativescript-plugin-firebase" {
       token: string;
     }
 
+    /**
+     * The returned object from the push function.
+     */
+    export interface PushResult {
+      key: string;
+    }
+
+    /**
+     * The returned object from the createUser function.
+     */
+    export interface CreateUserResult {
+      key: string;
+    }
+
     /**
      * The options object passed into the createUser function.
      */
@@ -89,10 +103,10 @@ declare module "nativescript-plugin-firebase" {
       value: any;
     }
 
-    export function init(options : InitOptions): Promise<any>;
-    export function login(options : LoginOptions): Promise<LoginResult>;
-    export function createUser(options: CreateUserOptions): Promise<any>;
-    export function push(path: string, value: any): Promise<any>;
+    export function init(options: InitOptions): Promise<any>;
+    export function login(options: LoginOptions): Promise<LoginResult>;
+    export function createUser(options: CreateUserOptions): Promise<CreateUserResult>;
+    export function push(path: string, value: any): Promise<PushResult>;
     export function setValue(path: string, value: any): Promise<any>;
     export function remove(path: string): Promise<any>;
     export function query(onValueEvent: (data: FBData) => void, path: string, options: QueryOptions): Promise<any>;

firebase.ios.js

@@ -107,7 +107,9 @@ firebase.createUser = function (arg) {
         if (error) {
           reject(error.localizedDescription);
         } else {
-          resolve(firebase.toJsObject(authData).uid);
+          resolve({
+            key: firebase.toJsObject(authData).uid
+          });
         }
       };
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "nativescript-plugin-firebase",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description" : "Fire. Base. Firebase!",
   "main" : "firebase.js",
   "nativescript": {