#132 [Feature request] Get Firebase timestamp

Author: EddyVerbruggen

docs/DATABASE.md

@@ -26,11 +26,10 @@ If you want to add data to a known path use this, otherwise use `push` (see belo
 The plugin will take care of serializing JSON data to native data structures.
 
 ```js
-
   // to store a JSON object
   firebase.setValue(
       '/companies',
-      {'foo':'bar'}
+      {foo:'bar'}
   );
 
   // to store an array of JSON objects
@@ -43,6 +42,21 @@ The plugin will take care of serializing JSON data to native data structures.
   );
 ```
 
+#### Adding an update timestamp
+If you want to have Firebase a timestamp to your data (instead of clients which likely are not synchronized),
+you can use the placeholder value `firebase.ServerValue.TIMESTAMP`, so for instance:
+
+```js
+  // to store a JSON object
+  firebase.setValue(
+      '/companies',
+      {
+        foo: 'bar',
+        updateTs: firebase.ServerValue.TIMESTAMP
+      }
+  );
+```
+
 ### push
 This function will store a JSON object at path `<Firebase URL>/users/<Generated Key>`
 

firebase-common.d.ts

@@ -123,6 +123,10 @@ firebase.init = function (arg) {
         return;
       }
 
+      firebase.ServerValue = {
+        TIMESTAMP: firebase.toJsObject(com.google.firebase.database.ServerValue.TIMESTAMP)
+      };
+
       var fDatabase = com.google.firebase.database.FirebaseDatabase;
       if (arg.persist) {
         fDatabase.getInstance().setPersistenceEnabled(true);

firebase.android.js

@@ -1,5 +1,70 @@
-/// <reference path="firebase-common.d.ts"/>
-declare module "nativescript-plugin-firebase" {
+declare module "nativescript-firebase" {
+
+    /**
+     * The allowed values for LoginOptions.type.
+     */
+    export enum LoginType {
+      /**
+       * No further data is required.
+       */
+      ANONYMOUS,
+      /**
+       * This requires you to pass in email and password properties as well.
+       */
+      PASSWORD,
+      /**
+       * This requires you to pass either an authentication token generated by your backend server
+       * or the tokenProviderFn function that returns a promise to provide the token.
+       * See: https://firebase.google.com/docs/auth/server
+       */
+      CUSTOM,
+      /**
+       * This requires you to setup Facebook Auth in the Firebase console,
+       * as well as uncommenting the SDK includes in include.gradle (Android) and Podfile (iOS).
+       */
+      FACEBOOK,
+      /**
+       * This requires you to setup Google Sign In in the Firebase console,
+       * as well as uncommenting the SDK includes in include.gradle (Android) and Podfile (iOS).
+       */
+      GOOGLE
+    }
+
+    /**
+     * The allowed values for QueryOptions.orderBy.type.
+     */
+    export enum QueryOrderByType {
+      KEY,
+      VALUE,
+      CHILD,
+      PRIORITY
+    }
+
+    /**
+     * The allowed values for QueryOptions.range.type.
+     */
+    export enum QueryRangeType {
+      START_AT,
+      END_AT,
+      EQUAL_TO
+    }
+
+    /**
+     * The allowed values for QueryOptions.limit.type.
+     */
+    export enum QueryLimitType {
+      FIRST,
+      LAST
+    }
+
+    export interface ServerValue {
+        /**
+         * When for instance using setValue you can set a timestamp property to this placeholder value.
+         * Example:
+         *   updateTs: firebase.ServerValue.TIMESTAMP
+         */
+        TIMESTAMP: any;
+    }
 
     /**
      * The options object passed into the init function.

firebase.d.ts

@@ -300,6 +300,10 @@ firebase.init = function (arg) {
         return;
       }
 
+      firebase.ServerValue = {
+        TIMESTAMP: FIRServerValue.timestamp()
+      };
+
       // this requires you to download GoogleService-Info.plist and
       // it to app/App_Resources/iOS/, see https://firebase.google.com/support/guides/firebase-ios
       FIRApp.configure();

firebase.ios.js

@@ -1,8 +1,9 @@
 {
   "name": "nativescript-plugin-firebase",
-  "version": "3.6.3",
+  "version": "3.6.4-dev",
   "description" : "Fire. Base. Firebase!",
   "main" : "firebase.js",
+  "typings": "firebase.d.ts",
   "nativescript": {
     "platforms": {
       "android": "2.3.0",