initial version

Author: EddyVerbruggen

.gitignore

@@ -0,0 +1 @@
+.idea

LICENSE

@@ -0,0 +1,19 @@
+The MIT License (MIT)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,314 @@
+# NativeScript Firebase plugin
+
+The leading realtime database.
+
+Android SDK downloaded from: https://www.firebase.com/docs/android/api/
+
+emulation commands:
+
+tns emulate ios --device iPhone-6s
+
+**TODO all below.**
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<img src="screenshots/ios-demoapp-slice.png" width="375px" height="196px" />
+
+### Use when
+* you want full map styling capability to match the uses of your app (example: downplaying highways for a running app),
+* you want a platform independent map implementation,
+* you care about performance so you don't want a web based solution,
+* you want an open source map implementation that you can tweak yourself,
+* you want to leverage Mapbox's backend to visualize massive geo data sets,
+* you want advanced analytics about your app's users.
+
+## Prerequisites
+NativeScript 1.3.0 (`tns --version`) is required for smooth installation, so please upgrade if you need to.
+
+You need a Mapbox API access token (they have a free Starter plan!), so [sign up with Mapbox](https://www.mapbox.com/signup/).
+Once you've registered go to your Account > Apps > New token. The 'Default Secret Token' is what you'll need.
+
+## Installation
+From the command prompt go to your app's root folder and execute:
+```
+tns plugin add nativescript-mapbox
+```
+
+## Usage
+
+If you want a quickstart, [clone our demo app](https://github.com/EddyVerbruggen/nativescript-mapbox-demo).
+And here's the comprehensive list of supported functions:
+
+### function: show
+```js
+  var mapbox = require("nativescript-mapbox");
+
+  mapbox.show({
+    accessToken: 'YOUR_API_ACCESS_TOKEN', // see 'Prerequisites' above
+    style: 'emerald', // light|dark|emerald|satellite|streets , default 'streets'
+    margins: {
+      left: 40, // default 0
+      right: 40, // default 0
+      top: 450, // default 0
+      bottom: 40 // default 0
+    },
+    center: { // optional without a default
+      lat: 52.3702160,
+      lng: 4.8951680
+    },
+    zoomLevel: 9.25, // 0-20, default 0
+    showUserLocation: true, // default false - requires location permissions on Android which you can remove from AndroidManifest.xml if you don't need them
+    hideAttribution: false, // default false, Mapbox requires this default if you're on a free plan
+    hideLogo: false, // default false, Mapbox requires this default if you're on a free plan
+    hideCompass: false, // default false
+    disableRotation: false, // default false
+    disableScroll: false, // default false
+    disableZoom: false, // default false
+    markers: [ // optional without a default
+      {
+        'lat': 52.3732160, // mandatory
+        'lng': 4.8941680, // mandatory
+        'title': 'Nice location', // recommended to pass in
+        'subtitle': 'Really really nice location' // one line is available on iOS, multiple on Android
+      }
+    ]
+  }).then(
+      function(result) {
+        console.log("Mapbox show done");
+      },
+      function(error) {
+        console.log("mapbox show error: " + error);
+      }
+  )
+```
+
+### function: hide
+All further examples assume `mapbox` has been required.
+Also, all functions support promises, but we're leaving out the `.then()` stuff for brevity where it doesn't add value.
+```js
+  mapbox.hide()
+```
+
+### function: addMarkers
+```js
+  mapbox.addMarkers([
+    {
+      'lat': 52.3602160, // mandatory
+      'lng': 4.8891680, // mandatory
+      'title': 'One-line title here', // no popup unless set
+      'subtitle': 'Infamous subtitle!'
+    },
+    {
+      ..
+    }
+  ])
+```
+
+### function: setCenter
+```js
+  mapbox.setCenter(
+      {
+        lat: 52.3602160, // mandatory
+        lng: 4.8891680, // mandatory
+        animated: false // default true
+      }
+  )
+```
+
+### function: getCenter
+Here the promise callback makes sense, so adding it to the example:
+```js
+  mapbox.getCenter().then(
+      function(result) {
+        console.log("Mapbox getCenter done, result: " + JSON.stringify(result));
+      },
+      function(error) {
+        console.log("mapbox getCenter error: " + error);
+      }
+  )
+```
+
+### function: setZoomLevel
+```js
+  mapbox.setZoomLevel(
+      {
+        level: 6.5, // mandatory, 0-20
+        animated: true // default true
+      }
+  )
+```
+
+### function: getZoomLevel
+```js
+  mapbox.getZoomLevel().then(
+      function(result) {
+        console.log("Mapbox getZoomLevel done, result: " + JSON.stringify(result));
+      },
+      function(error) {
+        console.log("mapbox getZoomLevel error: " + error);
+      }
+  )
+```
+
+### function: addPolygon
+Draw a shape (like a line/route, or star). Just connect the dots like we did as a child. The first person to tweet a snowman drawn with this function gets a T-shirt.
+```js
+  // this is a boring triangle drawn near Amsterdam Central Station
+  mapbox.addPolygon({
+    points: [
+      {
+        'lat': 52.3832160, // mandatory
+        'lng': 4.8991680 // mandatory
+      },
+      {
+        'lat': 52.3632160,
+        'lng': 4.9011680
+      },
+      {
+        'lat': 52.3932160,
+        'lng': 4.8911680
+      }
+    ]
+  })
+```
+
+### function: hasFineLocationPermission / requestFineLocationPermission
+On Android 6 you need to request permission to be able to show the user's position on the map at runtime when targeting API level 23+.
+Even if the `uses-permission` tag for `ACCESS_FINE_LOCATION` is present in `AndroidManifest.xml`.
+
+Note that `hasFineLocationPermission` will return true when:
+* You're running this on iOS, or
+* You're targeting an API level lower than 23, or
+* You're using Android < 6, or
+* You've already granted permission.
+
+```js
+  mapbox.hasFineLocationPermission().then(
+      function(granted) {
+        // if this is 'false' you probably want to call 'requestFineLocationPermission' now
+        console.log("Has Location Permission? " + result);
+      }
+  );
+
+  // if no permission was granted previously this wil open a user consent screen
+  mapbox.requestFineLocationPermission().then(
+      function() {
+        console.log("Location permission requested");
+      }
+  );
+```
+
+Note that the `show` function will also check for permission if you passed in `showUserLocation : true`.
+If you didn't request permission before showing the map, and permission was needed, then
+the location is not drawn on the map and the plugin will log an error to the console.

firebase-common.js

@@ -0,0 +1,3 @@
+var Firebase = {};
+
+module.exports = Firebase;

firebase.android.js

@@ -0,0 +1,14 @@
+var Firebase = require("./firebase-common");
+
+Firebase.show = function(arg) {
+  return new Promise(function (resolve, reject) {
+    try {
+      resolve();
+    } catch (ex) {
+      console.log("Error in Firebase.show: " + ex);
+      reject(ex);
+    }
+  });
+};
+
+module.exports = Firebase;

firebase.ios.js

@@ -0,0 +1,14 @@
+var Firebase = require("./firebase-common");
+
+Firebase.show = function (arg) {
+  return new Promise(function (resolve, reject) {
+    try {
+      resolve("Done");
+    } catch (ex) {
+      console.log("Error in Firebase.show: " + ex);
+      reject(ex);
+    }
+  });
+};
+
+module.exports = Firebase;