Ship 3.6.2

Author: EddyVerbruggen

CHANGELOG.md

@@ -1,5 +1,24 @@
 <img src="docs/images/firebase-logo.png" width="116px" height="32px" alt="Firebase"/>
 
+## 3.6.2 (2016, September 15)
+
+[Full changelog](https://github.com/EddyVerbruggen/nativescript-plugin-firebase/compare/3.6.1...3.6.2)
+
+### SDK versions
+If version numbers __changed__, clean your platform folders to avoid build errors.
+
+- iOS: 3.5.x
+- Android: 9.4.0
+
+### New
+- [#126](https://github.com/EddyVerbruggen/nativescript-plugin-firebase/issues/126) When `singleEvent` is `true` return data in the promise
+- [#129](https://github.com/EddyVerbruggen/nativescript-plugin-firebase/issues/129) Ability to remove listeners
+
+### Fixes
+- [#128](https://github.com/EddyVerbruggen/nativescript-plugin-firebase/issues/128) On Android `logEvent` may cause an exception
+
+
+
 ## 3.6.1 (2016, September 7)
 
 [Full changelog](https://github.com/EddyVerbruggen/nativescript-plugin-firebase/compare/3.5.4...3.6.1)

docs/DATABASE.md

@@ -146,7 +146,13 @@ The plugin will take care of serializing native data structures to JSON data.
   };
 
   // listen to changes in the /users path
-  firebase.addChildEventListener(onChildEvent, "/users");
+  firebase.addChildEventListener(onChildEvent, "/users").then(
+    function(listenerWrapper) {
+      var path = listenerWrapper.path;
+      var listeners = listenerWrapper.listeners; // an Array of listeners added
+      // you can store the wrapper somewhere to later call 'removeEventListeners'
+    }
+  );
 ```
 
 ### addValueEventListener
@@ -161,7 +167,30 @@ The link is for the iOS SDK, but it's the same for Android.
   };
 
   // listen to changes in the /companies path
-  firebase.addValueEventListener(onValueEvent, "/companies");
+  firebase.addValueEventListener(onValueEvent, "/companies").then(
+    function(listenerWrapper) {
+      var path = listenerWrapper.path;
+      var listeners = listenerWrapper.listeners; // an Array of listeners added
+      // you can store the wrapper somewhere to later call 'removeEventListeners'
+    }
+  );
+```
+    
+export function removeEventListeners(listeners: Array<any>, path: string): Promise<any>;
+
+### removeEventListeners
+Firebase does not automatically remove listeners when fi. a user logs out.
+So please keep track of these listeners yourself and remove them when appropriate.
+
+You can see an example of this in the [demo app](https://github.com/EddyVerbruggen/nativescript-plugin-firebase-demo/blob/master/Firebase/app/main-view-model.js).
+
+> Note that there was a bug in the Android runtime that was fixed in NativeScript 2.3.0 which caused a crash when using this function.
+
+```js
+  firebase.removeEventListeners(
+     listeners, // an Array of listeners
+     "/users" // the path the listener was previously listening to
+  );
 ```
 
 ### remove

package.json

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