chore(): update changelog

* feat(mixpanel): make MixpanelPeople return promises

* remove decorator from people property

* add cordova decorator'

* test(mixpanel): add mixpanel tests

* test(mixpanel): remove unused imports

* fix(mixpanel): fix MixpanelPeople class

closes #667

.github/CONTRIBUTING.md

@@ -1,18 +1,19 @@
 # Contributing to Ionic Native
 
-
-## Feature request?
-Have a plugin you'd like to see supported? Since Ionic Native is a thin wrapper around existing Cordova plugins, adding support for new plugins is as easy as creating a new wrapper for whatever plugin you'd like to add.
-
-Take a look at our [Developer Guide](https://github.com/driftyco/ionic-native/blob/master/DEVELOPER.md) for more info on adding new plugins.
-
 ## Have an issue?
 #### There are no rules, but here are a few things to consider:
 ###### Before you submit an issue:
 * Do a quick search to see if there are similar issues
-* **Check that you are using the latest version of** `ionic-native`
+* Make sure that you are waiting for `deviceready` to fire before interacting with any plugin. If you are using Ionic 2, this can be done using [the `Platform.ready()` function](http://ionicframework.com/docs/v2/api/platform/Platform/#ready).
+* **Check that you are using the latest version of** `ionic-native`, you can install the latest version by running `npm i --save ionic-native@latest`
 
 ###### Still having problems? submit an issue with the following details:
 * Short description of the issue
 * Steps to reproduce
 * Stack trace (if available)
+
+
+## Feature request?
+Have a plugin you'd like to see supported? Since Ionic Native is a thin wrapper around existing Cordova plugins, adding support for new plugins is as easy as creating a new wrapper for whatever plugin you'd like to add.
+
+Take a look at our [Developer Guide](https://github.com/driftyco/ionic-native/blob/master/DEVELOPER.md) for more info on adding new plugins.

CHANGELOG.md

@@ -1,17 +1,71 @@
+<a name="2.2.4"></a>
+## [2.2.4](https://github.com/driftyco/ionic-native/compare/v2.2.3...v2.2.4) (2016-10-15)
+
+
+### Bug Fixes
+
+* **sqlite:** fix callback order for transaction ([#700](https://github.com/driftyco/ionic-native/issues/700)) ([799e2f0](https://github.com/driftyco/ionic-native/commit/799e2f0))
+
+
+### Features
+
+* **device-feedback:** add DeviceFeedback plugin ([#696](https://github.com/driftyco/ionic-native/issues/696)) ([bbda6e2](https://github.com/driftyco/ionic-native/commit/bbda6e2))
+* **image-picker:** add new android methods ([3edfafb](https://github.com/driftyco/ionic-native/commit/3edfafb))
+* **mixpanel:** MixpanelPeople returns promises ([#681](https://github.com/driftyco/ionic-native/issues/681)) ([b95f88c](https://github.com/driftyco/ionic-native/commit/b95f88c)), closes [#667](https://github.com/driftyco/ionic-native/issues/667)
+
+
+
+<a name="2.2.3"></a>
+## [2.2.3](https://github.com/driftyco/ionic-native/compare/v2.2.2...v2.2.3) (2016-10-14)
+
+
+### Bug Fixes
+
+* **googlemaps:** Expose 'type' property in GoogleMapsLatLngBounds [#693](https://github.com/driftyco/ionic-native/issues/693) ([#694](https://github.com/driftyco/ionic-native/issues/694)) ([74a252b](https://github.com/driftyco/ionic-native/commit/74a252b))
+* **onesignal:** update to match latest API version ([#691](https://github.com/driftyco/ionic-native/issues/691)) ([babfb0d](https://github.com/driftyco/ionic-native/commit/babfb0d))
+
+
+
+<a name="2.2.2"></a>
+## [2.2.2](https://github.com/driftyco/ionic-native/compare/v2.2.1...v2.2.2) (2016-10-12)
+
+
+### Bug Fixes
+
+* **file:** getFreeDiskSpace now works ([d2f42ef](https://github.com/driftyco/ionic-native/commit/d2f42ef))
+* **file:** read methods can accept Blobs too ([276d61b](https://github.com/driftyco/ionic-native/commit/276d61b))
+
+
+### Features
+
+* **file:** getFile and getDirectory are now public ([5c92455](https://github.com/driftyco/ionic-native/commit/5c92455)), closes [#657](https://github.com/driftyco/ionic-native/issues/657)
+
+
+
+<a name="2.2.1"></a>
+## [2.2.1](https://github.com/driftyco/ionic-native/compare/v2.2.0...v2.2.1) (2016-10-12)
+
+
+### Bug Fixes
+
+* **diagnostic:** misspelled getContactsAuthorizationStatus method ([#678](https://github.com/driftyco/ionic-native/issues/678)) ([bff4862](https://github.com/driftyco/ionic-native/commit/bff4862))
+* **file:** fix writeFile method ([842a80d](https://github.com/driftyco/ionic-native/commit/842a80d))
+* **file:** last parameter for writeFile now only accepts options ([5710eb7](https://github.com/driftyco/ionic-native/commit/5710eb7))
+* **http:** export via window.IonicNative ([#675](https://github.com/driftyco/ionic-native/issues/675)) ([cf7abe1](https://github.com/driftyco/ionic-native/commit/cf7abe1))
+* **location-accuracy:** accuracy param is number ([c2d4f1c](https://github.com/driftyco/ionic-native/commit/c2d4f1c)), closes [#676](https://github.com/driftyco/ionic-native/issues/676)
+* **themeablebrowser:** add missed options ([#680](https://github.com/driftyco/ionic-native/issues/680)) ([e28e5b0](https://github.com/driftyco/ionic-native/commit/e28e5b0))
+
+
+### Features
+
+* **file:** resolveLocalFilesystemUrl and resolveDirectoryUrl are now public methods ([542ff4c](https://github.com/driftyco/ionic-native/commit/542ff4c)), closes [#657](https://github.com/driftyco/ionic-native/issues/657)
+
+
+
 <a name="2.2.0"></a>
 # [2.2.0](https://github.com/driftyco/ionic-native/compare/v2.1.9...v2.2.0) (2016-10-11)
 
 
-## BREAKING CHANGES
-
-### OneSignal
-The wrapper for this plugin has been updated to the match latest version of the plugin (2.x). If you are still using and older version of the plugin (1.x), you should use ionic-native v.2.1.x. 
-
-### ThemeableBrowser
-The wrapper for this plugin (and related interfaces) has been refactored to replace "Themable" with "Themeable". Please fix your existing code to match the new class and interfaces names.
-
-----
-
 ### Bug Fixes
 
 * **native-transitions:** add missing interface properties ([35c8bbd](https://github.com/driftyco/ionic-native/commit/35c8bbd))

package.json

@@ -1,6 +1,6 @@
 {
   "name": "ionic-native",
-  "version": "2.2.0",
+  "version": "2.2.4",
   "description": "Native plugin wrappers for Cordova and Ionic with TypeScript, ES6+, Promise and Observable support",
   "main": "dist/es5/index.js",
   "module": "dist/esm/index.js",

src/index.ts

@@ -32,6 +32,7 @@ import { DatePicker } from './plugins/datepicker';
 import { DBMeter } from './plugins/dbmeter';
 import { Deeplinks } from './plugins/deeplinks';
 import { Device } from './plugins/device';
+import { DeviceFeedback } from './plugins/device-feedback';
 import { DeviceAccounts } from './plugins/deviceaccounts';
 import { DeviceMotion } from './plugins/devicemotion';
 import { DeviceOrientation } from './plugins/deviceorientation';
@@ -52,6 +53,7 @@ import { GooglePlus } from './plugins/google-plus';
 import { GoogleMap } from './plugins/googlemaps';
 import { GoogleAnalytics } from './plugins/googleanalytics';
 import { Hotspot } from  './plugins/hotspot';
+import { HTTP } from  './plugins/http';
 import { Httpd } from './plugins/httpd';
 import { IBeacon } from './plugins/ibeacon';
 import { ImagePicker } from './plugins/imagepicker';
@@ -138,6 +140,7 @@ export * from './plugins/datepicker';
 export * from './plugins/dbmeter';
 export * from './plugins/deeplinks';
 export * from './plugins/device';
+export * from './plugins/device-feedback';
 export * from './plugins/deviceaccounts';
 export * from './plugins/devicemotion';
 export * from './plugins/deviceorientation';
@@ -247,6 +250,7 @@ window['IonicNative'] = {
   DBMeter,
   Deeplinks,
   Device,
+  DeviceFeedback,
   DeviceAccounts,
   DeviceMotion,
   DeviceOrientation,
@@ -266,6 +270,7 @@ window['IonicNative'] = {
   GoogleMap,
   GoogleAnalytics,
   Hotspot,
+  HTTP,
   Httpd,
   IBeacon,
   ImagePicker,

src/plugins/background-geolocation.ts

@@ -236,8 +236,8 @@ export interface Config {
  *
  * // When device is ready :
  * platform.ready().then(() => {
- *     // IMPORTANT: BackgroundGeolocation must be called within app.ts and or before Geolocation. Otherwise the platform will not ask you for background tracking permission. 
- * 
+ *     // IMPORTANT: BackgroundGeolocation must be called within app.ts and or before Geolocation. Otherwise the platform will not ask you for background tracking permission.
+ *
  *     // BackgroundGeolocation is highly configurable. See platform specific configuration options
  *     let config = {
  *             desiredAccuracy: 10,
@@ -330,10 +330,9 @@ export class BackgroundGeolocation {
   /**
    * Configure the plugin.
    *
-   * @param {Function} Success callback will be called when background location is determined.
-   * @param {Function} Fail callback to be executed every time a geolocation error occurs.
-   * @param {Object} An object of type Config
-   *
+   * @param {Function} callback callback will be called when background location is determined.
+   * @param {Function} errorCallback callback to be executed every time a geolocation error occurs.
+   * @param {Config} options An object of type Config
    * @return Location object, which tries to mimic w3c Coordinates interface.
    * See http://dev.w3.org/geo/api/spec-source.html#coordinates_interface
    * Callback to be executed every time a geolocation is recorded in the background.
@@ -341,7 +340,7 @@ export class BackgroundGeolocation {
   @Cordova({
     sync: true
   })
-  static configure(callback: Function, errorCallback: Function, options: Config): void { return; }
+  static configure(callback: Function, errorCallback: Function, options: Config): any { return; }
 
   /**
    * Turn ON the background-geolocation system.

src/plugins/ble.ts

@@ -400,17 +400,10 @@ export class BLE {
   /**
    * Report if bluetooth is enabled.
    *
-   * @usage
-   * ```
-   * BLE.isEnabled().then(
-   *   () => { console.log('enabled'); },
-   *   () => { console.log('not enabled'); }
-   * );
-   * ```
-   * @return Returns a Promise.
+   * @return {Promise<void>} Returns a Promise that resolves if Bluetooth is enabled, and rejects if disabled.
    */
   @Cordova()
-  static isEnabled(): Promise<any> { return; }
+  static isEnabled(): Promise<void> { return; }
 
   /**
    * Open System Bluetooth settings (Android only).

src/plugins/camera-preview.ts

@@ -19,7 +19,7 @@ export interface CameraPreviewSize {
  * @description
  * Showing camera preview in HTML
  *
- * For more info, please see the [Cordova Camera Preview Plugin Docs](https://github.com/westonganger/cordova-plugin-camera-preview').
+ * For more info, please see the [Cordova Camera Preview Plugin Docs](https://github.com/westonganger/cordova-plugin-camera-preview).
  *
  * @usage
  * ```

src/plugins/datepicker.ts

@@ -1,66 +1,104 @@
-import { Cordova, Plugin } from './plugin';
+import {Cordova, Plugin} from './plugin';
 
 
 export interface DatePickerOptions {
   /**
-   * Platforms: iOS, Android, Windows
    * The mode of the date picker
    * Values: date | time | datetime
    */
   mode: string;
 
   /**
-   * Platforms: iOS, Android, Windows
    * Selected date
    */
   date: Date | string | number;
 
   /**
-   * Platforms: iOS, Android, Windows
    * Minimum date
-   * Type: Date | empty String
    * Default: empty String
    */
   minDate?: Date | string | number;
 
   /**
-   * Platforms?: iOS, Android, Windows
    * Maximum date
-   * Type?: Date | empty String
    * Default?: empty String
    */
   maxDate?: Date | string | number;
 
   /**
-   * Platforms?: Android
    * Label for the dialog title. If empty, uses android default (Set date/Set time).
-   * Type?: String
    * Default?: empty String
    */
   titleText?: string;
 
   /**
-   * Platforms?: Android
    * Label of BUTTON_POSITIVE (done button) on Android
    */
   okText?: string;
-
-  // TODO complete documentation here, and copy params & docs to main plugin docs
+  /**
+   * Label of BUTTON_NEGATIVE (cancel button). If empty, uses android.R.string.cancel.
+   */
   cancelText?: string;
+  /**
+   * Label of today button. If empty, doesn't show the option to select current date.
+   */
   todayText?: string;
+  /**
+   * Label of now button. If empty, doesn't show the option to select current time.
+   */
   nowText?: string;
+  /**
+   * Shows time dialog in 24 hours format.
+   */
   is24Hour?: boolean;
+  /**
+   * Choose the Android theme for the picker. You can use the DatePicker.ANDROID_THEMES property.
+   * Values: 1: THEME_TRADITIONAL | 2: THEME_HOLO_DARK | 3: THEME_HOLO_LIGHT | 4: THEME_DEVICE_DEFAULT_DARK | 5: THEME_DEVICE_DEFAULT_LIGHT
+   */
   androidTheme?: number;
+  /**
+   * Shows or hide dates earlier then selected date.
+   */
   allowOldDate?: boolean;
+  /**
+   * Shows or hide dates after selected date.
+   */
   allowFutureDates?: boolean;
+  /**
+   * Label of done button.
+   */
   doneButtonLabel?: string;
+  /**
+   * Hex color of done button.
+   */
   doneButtonColor?: string;
+  /**
+   * Label of cancel button.
+   */
   cancelButtonLabel?: string;
+  /**
+   * Hex color of cancel button.
+   */
   cancelButtonColor?: string;
+  /**
+   * X position of date picker. The position is absolute to the root view of the application.
+   */
   x?: number;
+  /**
+   * Y position of date picker. The position is absolute to the root view of the application.
+   */
   y?: number;
+  /**
+   * Interval between options in the minute section of the date picker.
+   */
   minuteInterval?: number;
+  /**
+   * Force the UIPopoverArrowDirection enum. The value any will revert to default UIPopoverArrowDirectionAny and let the app choose the proper direction itself.
+   */
   popoverArrowDirection?: string;
+  /**
+   * Force locale for datePicker.
+   */
   locale?: string;
 }
 
@@ -86,7 +124,8 @@ export interface DatePickerOptions {
  *   err => console.log('Error occurred while getting date: ', err)
  * );
  * ```
- *
+ * @interfaces
+ * DatePickerOptions
  */
 @Plugin({
   plugin: 'cordova-plugin-datepicker',
@@ -95,12 +134,25 @@ export interface DatePickerOptions {
 })
 export class DatePicker {
 
+  /**
+   * @private
+   */
+  static ANDROID_THEMES = {
+    THEME_TRADITIONAL: 1,
+    THEME_HOLO_DARK: 2,
+    THEME_HOLO_LIGHT: 3,
+    THEME_DEVICE_DEFAULT_DARK: 4,
+    THEME_DEVICE_DEFAULT_LIGHT: 5
+  };
+
   /**
    * Shows the date and/or time picker dialog(s)
    * @param {DatePickerOptions} options Options for the date picker.
    * @returns {Promise<Date>} Returns a promise that resolves with the picked date and/or time, or rejects with an error.
    */
   @Cordova()
-  static show(options: DatePickerOptions): Promise<Date> { return; }
+  static show(options: DatePickerOptions): Promise<Date> {
+    return;
+  }
 
 }

src/plugins/device-feedback.ts

@@ -0,0 +1,54 @@
+import {Plugin, Cordova} from './plugin';
+/**
+ * @name DeviceFeedback
+ * @description
+ *
+ * Plugin that lets you provide haptic or acoustic feedback on Android devices.
+ *
+ * @usage
+ * ```
+ * import { DeviceFeedback } from 'ionic-native';
+ *
+ * DeviceFeedback.acoustic();
+ *
+ * DeviceFeedback.haptic(0);
+ *
+ * DeviceFeedback.isFeedbackEnabled()
+ *   .then((feedback) => {
+ *     console.log(feedback);
+ *     // {
+ *     //   acoustic: true,
+ *     //   haptic: true
+ *     // }
+ *   });
+ *
+ * ```
+ */
+@Plugin({
+  plugin: 'cordova-plugin-velda-devicefeedback',
+  pluginRef: 'plugins.deviceFeedback',
+  repo: 'https://github.com/VVelda/device-feedback',
+  platforms: ['Android']
+})
+export class DeviceFeedback {
+
+  /**
+   * Provide sound feedback to user, nevertheless respect user's settings and current active device profile as native feedback do.
+   */
+  @Cordova({ sync: true })
+  static acoustic(): void { }
+
+  /**
+   * Provide vibrate feedback to user, nevertheless respect user's tactile feedback setting as native feedback do.
+   * @param type {Number} Specify type of vibration feedback. 0 for long press, 1 for virtual key, or 3 for keyboard tap.
+   */
+  @Cordova({ sync: true })
+  static haptic(type: number): void { }
+
+  /**
+   * Check if haptic and acoustic feedback is enabled by user settings.
+   */
+  @Cordova()
+  static isFeedbackEnabled(): Promise<{ haptic: boolean; acoustic: boolean; }> { return; }
+
+}

src/plugins/diagnostic.ts

@@ -279,7 +279,7 @@ export class Diagnostic {
    * @returns {Promise<any>}
    */
   @Cordova({ platforms: ['Android', 'iOS'] })
-  static getContactsAuthroizationStatus(): Promise<any> { return; }
+  static getContactsAuthorizationStatus(): Promise<any> { return; }
 
   /**
    * Requests contacts authorization for the application.

src/plugins/file.ts

@@ -1,4 +1,4 @@
-import { Plugin, Cordova } from './plugin';
+import { Plugin, pluginWarn } from './plugin';
 
 declare var window: any;
 declare var cordova: any;
@@ -301,10 +301,10 @@ export interface FileReader {
   onabort: (evt: ProgressEvent) => void;
 
   abort(): void;
-  readAsText(fe: File, encoding?: string): void;
-  readAsDataURL(fe: File): void;
-  readAsBinaryString(fe: File): void;
-  readAsArrayBuffer(fe: File): void;
+  readAsText(fe: File | Blob, encoding?: string): void;
+  readAsDataURL(fe: File | Blob): void;
+  readAsBinaryString(fe: File | Blob): void;
+  readAsArrayBuffer(fe: File | Blob): void;
 }
 
 declare var FileReader: {
@@ -337,6 +337,12 @@ declare var FileError: {
   PATH_EXISTS_ERR: number;
 };
 
+let pluginMeta = {
+  plugin: 'cordova-plugin-file',
+  pluginRef: 'cordova.file',
+  repo: 'https://github.com/apache/cordova-plugin-file'
+};
+
 /**
  * @name File
  * @description
@@ -358,11 +364,7 @@ declare var FileError: {
  *  Although most of the plugin code was written when an earlier spec was current: http://www.w3.org/TR/2011/WD-file-system-api-20110419/
  *  It also implements the FileWriter spec : http://dev.w3.org/2009/dap/file-system/file-writer.html
  */
-@Plugin({
-  plugin: 'cordova-plugin-file',
-  pluginRef: 'cordova.file',
-  repo: 'https://github.com/apache/cordova-plugin-file'
-})
+@Plugin(pluginMeta)
 export class File {
   static cordovaFileError: {} = {
     1: 'NOT_FOUND_ERR',
@@ -381,9 +383,19 @@ export class File {
     14: 'DIR_READ_ERR',
   };
 
-  @Cordova()
+  /**
+   * Get free disk space
+   * @returns {Promise<number>} Returns a promise that resolves with the remaining free disk space
+   */
   static getFreeDiskSpace(): Promise<number> {
-    return;
+    return new Promise<any>((resolve, reject) => {
+      if (!cordova || !cordova.exec) {
+        pluginWarn(pluginMeta);
+        reject({ error: 'plugin_not_installed' });
+      } else {
+        cordova.exec(resolve, reject, 'File', 'getFreeDiskSpace', []);
+      }
+    });
   }
 
   /**
@@ -393,7 +405,6 @@ export class File {
    * @param {string} dir Name of directory to check
    * @return {Promise<boolean|FileError>} Returns a Promise that resolves to true if the directory exists or rejects with an error.
    */
-
   static checkDir(path: string, dir: string): Promise<boolean|FileError> {
     if ((/^\//.test(dir))) {
       let err = new FileError(5);
@@ -418,7 +429,6 @@ export class File {
    * @param {boolean} replace If true, replaces file with same name. If false returns error
    * @return {Promise<DirectoryEntry|FileError>} Returns a Promise that resolves with a DirectoryEntry or rejects with an error.
    */
-
   static createDir(path: string, dirName: string, replace: boolean): Promise<DirectoryEntry|FileError> {
     if ((/^\//.test(dirName))) {
       let err = new FileError(5);
@@ -447,7 +457,6 @@ export class File {
    * @param {string} dirName The directory name
    * @return {Promise<RemoveResult|FileError>} Returns a Promise that resolves to a RemoveResult or rejects with an error.
    */
-
   static removeDir(path: string, dirName: string): Promise<RemoveResult|FileError> {
     if ((/^\//.test(dirName))) {
       let err = new FileError(5);
@@ -473,7 +482,6 @@ export class File {
    * @param {string} newDirName The destination directory name
    * @return {Promise<DirectoryEntry|Entry|FileError>} Returns a Promise that resolves to the new DirectoryEntry object or rejects with an error.
    */
-
   static moveDir(path: string, dirName: string, newPath: string, newDirName: string): Promise<DirectoryEntry|Entry|FileError> {
     newDirName = newDirName || dirName;
 
@@ -530,7 +538,6 @@ export class File {
    * @param {string} dirName Name of directory
    * @return {Promise<Entry[]>} Returns a Promise that resolves to an array of Entry objects or rejects with an error.
    */
-
   static listDir(path: string, dirName: string): Promise<Entry[]> {
     if ((/^\//.test(dirName))) {
       let err = new FileError(5);
@@ -555,7 +562,6 @@ export class File {
    * @param {string} dirName Name of directory
    * @return {Promise<RemoveResult>} Returns a Promise that resolves with a RemoveResult or rejects with an error.
    */
-
   static removeRecursively(path: string, dirName: string): Promise<RemoveResult> {
     if ((/^\//.test(dirName))) {
       let err = new FileError(5);
@@ -579,7 +585,6 @@ export class File {
    * @param {string} file Name of file to check
    * @return {Promise<boolean|FileError>} Returns a Promise that resolves with a boolean or rejects with an error.
    */
-
   static checkFile(path: string, file: string): Promise<boolean|FileError> {
     if ((/^\//.test(file))) {
       let err = new FileError(5);
@@ -637,7 +642,6 @@ export class File {
    * @param {string} fileName Name of file to remove
    * @return {Promise<RemoveResult|FileError>} Returns a Promise that resolves to a RemoveResult or rejects with an error.
    */
-
   static removeFile(path: string, fileName: string): Promise<RemoveResult|FileError> {
     if ((/^\//.test(fileName))) {
       let err = new FileError(5);
@@ -659,38 +663,37 @@ export class File {
    * @param {string} path Base FileSystem. Please refer to the iOS and Android filesystems above
    * @param {string} fileName path relative to base path
    * @param {string | Blob} text content or blob to write
-   * @param {boolean | WriteOptions} replaceOrOptions replace file if set to true. See WriteOptions for more information.
+   * @param {WriteOptions} options replace file if set to true. See WriteOptions for more information.
    * @returns {Promise<void>} Returns a Promise that resolves or rejects with an error.
    */
   static writeFile(path: string, fileName: string,
-                   text: string | Blob, replaceOrOptions: boolean | WriteOptions): Promise<void> {
+                   text: string | Blob, options: WriteOptions): Promise<void> {
     if ((/^\//.test(fileName))) {
       let err = new FileError(5);
       err.message = 'file-name cannot start with \/';
       return Promise.reject(err);
     }
 
-    let opts: WriteOptions = {};
-    if (replaceOrOptions) {
-      if (typeof(replaceOrOptions) === 'boolean') {
-        opts.replace = <boolean>replaceOrOptions;
-      }
-    }
+    let getFileOpts: Flags = {
+      create: true,
+      exclusive: options.replace
+    };
 
     return File.resolveDirectoryUrl(path)
       .then((fse) => {
-        return File.getFile(fse, fileName, opts);
+        return File.getFile(fse, fileName, getFileOpts);
       })
       .then((fe) => {
         return File.createWriter(fe);
       })
       .then((writer) => {
-        if (opts.append) {
+
+        if (options.append) {
           writer.seek(writer.length);
         }
 
-        if (opts.hasOwnProperty('truncate')) {
-          writer.truncate(opts.truncate);
+        if (options.truncate) {
+          writer.truncate(options.truncate);
         }
 
         return File.write(writer, text);
@@ -959,12 +962,14 @@ export class File {
   }
 
   /**
-   * @private
+   * Resolves a local file system URL
+   * @param fileUrl {string} file system url
+   * @returns {Promise<Entry>}
    */
-  private static resolveLocalFilesystemUrl(furl: string): Promise<Entry> {
+  static resolveLocalFilesystemUrl(fileUrl: string): Promise<Entry> {
     return new Promise<Entry>((resolve, reject) => {
       try {
-        window.resolveLocalFileSystemURL(furl, (entry) => {
+        window.resolveLocalFileSystemURL(fileUrl, (entry) => {
           resolve(entry);
         }, (err) => {
           File.fillErrorMessage(err);
@@ -978,10 +983,12 @@ export class File {
   }
 
   /**
-   * @private
+   * Resolves a local directory url
+   * @param directoryUrl {string} directory system url
+   * @returns {Promise<DirectoryEntry>}
    */
-  private static resolveDirectoryUrl(durl: string): Promise<DirectoryEntry> {
-    return File.resolveLocalFilesystemUrl(durl)
+  static resolveDirectoryUrl(directoryUrl: string): Promise<DirectoryEntry> {
+    return File.resolveLocalFilesystemUrl(directoryUrl)
       .then((de) => {
         if (de.isDirectory) {
           return <DirectoryEntry>de;
@@ -994,12 +1001,16 @@ export class File {
   }
 
   /**
-   * @private
+   * Get a directory
+   * @param directoryEntry {DirectoryEntry} Directory entry, obtained by resolveDirectoryUrl method
+   * @param directoryName {string} Directory name
+   * @param flags {Flags} Options
+   * @returns {Promise<DirectoryEntry>}
    */
-  private static getDirectory(fse: DirectoryEntry, dn: string, flags: Flags): Promise<DirectoryEntry> {
+  static getDirectory(directoryEntry: DirectoryEntry, directoryName: string, flags: Flags): Promise<DirectoryEntry> {
     return new Promise<DirectoryEntry>((resolve, reject) => {
       try {
-        fse.getDirectory(dn, flags, (de) => {
+        directoryEntry.getDirectory(directoryName, flags, (de) => {
           resolve(de);
         }, (err) => {
           File.fillErrorMessage(err);
@@ -1013,14 +1024,16 @@ export class File {
   }
 
   /**
-   * @private
+   * Get a file
+   * @param directoryEntry {DirectoryEntry} Directory entry, obtained by resolveDirectoryUrl method
+   * @param fileName {string} File name
+   * @param flags {Flags} Options
+   * @returns {Promise<FileEntry>}
    */
-  private static getFile(fse: DirectoryEntry, fn: string, flags: Flags): Promise<FileEntry> {
+  static getFile(directoryEntry: DirectoryEntry, fileName: string, flags: Flags): Promise<FileEntry> {
     return new Promise<FileEntry>((resolve, reject) => {
       try {
-        fse.getFile(fn, flags, (fe) => {
-          resolve(fe);
-        }, (err) => {
+        directoryEntry.getFile(fileName, flags, resolve, (err) => {
           File.fillErrorMessage(err);
           reject(err);
         });
@@ -1123,12 +1136,12 @@ export class File {
       return this.writeFileInChunks(writer, gu);
     }
 
-    return new Promise<void>((resolve, reject) => {
+    return new Promise<any>((resolve, reject) => {
       writer.onwriteend = (evt) => {
         if (writer.error) {
           reject(writer.error);
         } else {
-          resolve();
+          resolve(evt);
         }
       };
       writer.write(gu);

src/plugins/googlemaps.ts

@@ -885,6 +885,7 @@ export class GoogleMapsLatLngBounds {
 
   @InstanceProperty get northeast(): GoogleMapsLatLng { return; }
   @InstanceProperty get southwest(): GoogleMapsLatLng { return; }
+  @InstanceProperty get type(): string { return; }
 
   constructor(southwestOrArrayOfLatLng: GoogleMapsLatLng | GoogleMapsLatLng[], northeast?: GoogleMapsLatLng) {
     let args = !!northeast ? [southwestOrArrayOfLatLng, northeast] : southwestOrArrayOfLatLng;

src/plugins/http.ts

@@ -1,4 +1,4 @@
-import {Plugin, Cordova} from './plugin';
+import { Plugin, Cordova } from './plugin';
 /**
  * @name HTTP
  * @description
@@ -35,7 +35,8 @@ import {Plugin, Cordova} from './plugin';
 @Plugin({
   plugin: 'cordova-plugin-http',
   pluginRef: 'cordovaHTTP',
-  repo: 'https://github.com/wymsee/cordova-HTTP'
+  repo: 'https://github.com/wymsee/cordova-HTTP',
+  platforms: ['Android', 'iOS']
 })
 export class HTTP {
 
@@ -118,11 +119,11 @@ export class HTTP {
    * @param body {Object} The body of the request
    * @param headers {Object} The headers to set for this request
    * @param filePath {string} The local path of the file to upload
-   * @param fileParameter {string} The name of the parameter to pass the file along as
+   * @param name {string} The name of the parameter to pass the file along as
    * @return {Promise<HTTPResponse>} returns a promise that resolve on success, and reject on failure
    */
   @Cordova()
-  static uploadFile(url: string, body: any, headers: any, filePath: string, fileParameter: string): Promise<HTTPResponse> { return; }
+  static uploadFile(url: string, body: any, headers: any, filePath: string, name: string): Promise<HTTPResponse> { return; }
 
   /**
    *
@@ -134,8 +135,6 @@ export class HTTP {
    */
   @Cordova()
   static downloadFile(url: string, body: any, headers: any, filePath: string): Promise<HTTPResponse> { return; }
-
-
 }
 
 export interface HTTPResponse {

src/plugins/imagepicker.ts

@@ -2,19 +2,23 @@ import { Cordova, Plugin } from './plugin';
 
 
 export interface ImagePickerOptions {
-  // max images to be selected, defaults to 15. If this is set to 1, upon
-  // selection of a single image, the plugin will return it.
+  /**
+   * max images to be selected, defaults to 15. If this is set to 1, upon selection of a single image, the plugin will return it.
+   */
   maximumImagesCount?: number;
 
-  // max width and height to allow the images to be.  Will keep aspect
-  // ratio no matter what.  So if both are 800, the returned image
-  // will be at most 800 pixels wide and 800 pixels tall.  If the width is
-  // 800 and height 0 the image will be 800 pixels wide if the source
-  // is at least that wide.
+  /**
+   * Max width to allow images to be
+   */
   width?: number;
+  /**
+   * Max height to allow images to be
+   */
   height?: number;
 
-  // quality of resized image, defaults to 100
+  /**
+   * Quality of images, defaults to 100
+   */
   quality?: number;
 }
 
@@ -38,6 +42,8 @@ export interface ImagePickerOptions {
  *   }
  * }, (err) => { });
  * ```
+ * @interfaces
+ * ImagePickerOptions
  */
 @Plugin({
   plugin: 'cordova-plugin-image-picker',
@@ -56,4 +62,22 @@ export class ImagePicker {
   })
   static getPictures(options: ImagePickerOptions): Promise<any> { return; }
 
+  /**
+   * Check if we have permission to read images
+   * @returns {Promise<boolean>} Returns a promise that resolves with a boolean that indicates whether we have permission
+   */
+  @Cordova({
+    platforms: ['Android']
+  })
+  static hasReadPermission(): Promise<boolean> { return; }
+
+  /**
+   * Request permission to read images
+   * @returns {Promise<any>}
+   */
+  @Cordova({
+    platforms: ['Android']
+  })
+  static requestReadPermission(): Promise<any> { return; }
+
 }

src/plugins/location-accuracy.ts

@@ -44,10 +44,11 @@ export class LocationAccuracy {
 
   /**
    * Requests accurate location
+   * @param accuracy {number} Accuracy, from 0 to 4. You can use the static properties of this class that start with REQUEST_PRIORITY_
    * @returns {Promise<any>} Returns a promise that resolves on success and rejects if an error occurred
    */
   @Cordova({ callbackOrder: 'reverse' })
-  static request(accuracy: string): Promise<any> { return; }
+  static request(accuracy: number): Promise<any> { return; }
 
   static REQUEST_PRIORITY_NO_POWER = 0;
   static REQUEST_PRIORITY_LOW_POWER = 1;

src/plugins/mixpanel.ts

@@ -1,7 +1,15 @@
-import { Cordova, CordovaProperty, Plugin } from './plugin';
+import { Cordova, Plugin } from './plugin';
 
 declare var mixpanel: any;
 
+/**
+ * @private
+ */
+export const pluginMeta = {
+  plugin: 'cordova-plugin-mixpanel',
+  pluginRef: 'mixpanel',
+  repo: 'https://github.com/samzilverberg/cordova-mixpanel-plugin'
+};
 
 /**
  * @name Mixpanel
@@ -18,11 +26,7 @@ declare var mixpanel: any;
  *
  * ```
  */
-@Plugin({
-  plugin: 'cordova-plugin-mixpanel',
-  pluginRef: 'mixpanel',
-  repo: 'https://github.com/samzilverberg/cordova-mixpanel-plugin'
-})
+@Plugin(pluginMeta)
 export class Mixpanel {
   /**
    *
@@ -96,17 +100,61 @@ export class Mixpanel {
    *
    * @returns {MixpanelPeople}
    */
-  @CordovaProperty
-  static get people(): MixpanelPeople { return mixpanel.people; };
+  static get people(): typeof MixpanelPeople {
+    return MixpanelPeople;
+  };
 
 }
 /**
  * @private
  */
-export declare class MixpanelPeople {
-  static identify(distinctId: string, onSuccess?: Function, onFail?: Function): void;
-  static increment(peopleProperties: any, onSuccess?: Function, onFail?: Function): void;
-  static setPushId(pushId: string, onSuccess?: Function, onFail?: Function): void;
-  static set(peopleProperties: any, onSuccess?: Function, onFail?: Function): void;
-  static setOnce(peopleProperties: any, onSuccess?: Function, onFail?: Function): void;
+export class MixpanelPeople {
+  /**
+   * @private
+   */
+  static plugin: string = pluginMeta.plugin;
+  /**
+   * @private
+   */
+  static pluginRef: string = pluginMeta.pluginRef + '.people';
+
+  /**
+   *
+   * @param distinctId {string}
+   * @return {Promise<any>}
+   */
+  @Cordova()
+  static identify(distinctId: string): Promise<any> { return; }
+
+  /**
+   *
+   * @param peopleProperties {string}
+   * @return {Promise<any>}
+   */
+  @Cordova()
+  static increment(peopleProperties: any): Promise<any> { return; }
+
+  /**
+   *
+   * @param pushId
+   * @return {Promise<any>}
+   */
+  @Cordova()
+  static setPushId(pushId: string): Promise<any> { return; }
+
+  /**
+   *
+   * @param peopleProperties
+   * @return {Promise<any>}
+   */
+  @Cordova()
+  static set(peopleProperties: any): Promise<any> { return; }
+
+  /**
+   *
+   * @param peopleProperties
+   * @return {Promise<any>}
+   */
+  @Cordova()
+  static setOnce(peopleProperties: any): Promise<any> { return; }
 }

src/plugins/onesignal.ts

@@ -1,7 +1,6 @@
 import { Cordova, Plugin } from './plugin';
 import { Observable } from 'rxjs/Observable';
 
-
 /**
  * @name OneSignal
  * @description
@@ -16,7 +15,7 @@ import { Observable } from 'rxjs/Observable';
  *
  * OneSignal.startInit('b2f7f966-d8cc-11e4-bed1-df8f05be55ba', '703322744261');
  *
- * OneSignal.enableInAppAlertNotification(true);
+ * OneSignal.inFocusDisplaying(OneSignal.OSInFocusDisplayOption.InAppAlert);
  *
  * OneSignal.handleNotificationReceived().subscribe(() => {
  *  // do something when notification is received
@@ -38,7 +37,7 @@ import { Observable } from 'rxjs/Observable';
 export class OneSignal {
 
   /**
-   * @private
+   * constants to use in inFocusDisplaying()
    */
   static OSInFocusDisplayOption = {
     None: 0,
@@ -172,17 +171,13 @@ export class OneSignal {
   static enableSound(enable: boolean): void { }
 
   /**
-  * Warning:
-  * Only applies to Android and Amazon devices.
   *
-  * By default this is false and notifications will not be shown when the user is in your app, instead the notificationOpenedCallback is fired.
-  * If set to true notifications will always show in the notification area and notificationOpenedCallback will not fire until the user taps on the notification.
+  * Setting to control how OneSignal notifications will be shown when one is received while your app is in focus. By default this is set to inAppAlert, which can be helpful during development.
   *
-  * @param {boolean} enable
+  * @param {number} displayOption Options are 0 = None, 1 = InAppAlert, and 2 = Notification.
   */
   @Cordova({ sync: true })
-  static enableNotificationsWhenActive(enable: boolean): void { }
-
+  static inFocusDisplaying(displayOption: number): void { }
 
   /**
   * You can call this method with false to opt users out of receiving all notifications through OneSignal.

src/plugins/sqlite.ts

@@ -87,7 +87,10 @@ export class SQLite {
   })
   addTransaction(transaction: any): void { }
 
-  @CordovaInstance()
+  @CordovaInstance({
+    successIndex: 2,
+    errorIndex: 1
+  })
   transaction(fn: any): Promise<any> { return; }
 
   @CordovaInstance()

src/plugins/themeable-browser.ts

@@ -15,12 +15,19 @@ export interface ThemeableBrowserButton {
 }
 
 export interface ThemeableBrowserOptions {
-  statusbar?: { color: string; };
+  statusbar?: {
+    color: string;
+  };
   toolbar?: {
     height?: number;
     color?: string;
+    image?: string;
+  };
+  title?: {
+    color?: string;
+    staticText?: string;
+    showPageTitle?: boolean;
   };
-  title?: { color: string; };
   backButton?: ThemeableBrowserButton;
   forwardButton?: ThemeableBrowserButton;
   closeButton?: ThemeableBrowserButton;
@@ -37,6 +44,7 @@ export interface ThemeableBrowserOptions {
     }[];
   };
   backButtonCanClose?: boolean;
+  disableAnimation?: boolean;
 
   // inAppBrowser options
   location?: string;

src/plugins/toast.ts

@@ -53,6 +53,8 @@ export interface ToastOptions {
  *   }
  * );
  * ```
+ * @interfaces
+ * ToastOptions
  */
 @Plugin({
   plugin: 'cordova-plugin-x-toast',

test/plugin.spec.ts

@@ -1,4 +1,4 @@
-/// <reference path="./../typings/index.d.ts" />
+/// <reference path="../typings/index.d.ts" />
 
 import 'es6-shim';
 import {Plugin, Cordova} from './../src/plugins/plugin';

test/plugins/mixpanel.spec.ts

@@ -0,0 +1,28 @@
+import {Mixpanel} from '../../src/plugins/mixpanel';
+declare const window: any;
+
+window.mixpanel = {
+  people: {
+    identify: (args, success, error) => success('Success')
+  }
+};
+
+describe('Mixpanel', () => {
+
+  it('should return MixpanelPeople', () => {
+    expect(Mixpanel.people).toBeDefined();
+    expect(Mixpanel.people.identify).toBeDefined();
+  });
+
+  it('should call a method of MixpanelPeople', (done) => {
+    const spy = spyOn(window.mixpanel.people, 'identify').and.callThrough();
+    Mixpanel.people.identify('veryDistinctSuchIdVeryWow')
+      .then(result => {
+        expect(result).toEqual('Success');
+        done();
+      });
+    expect(spy.calls.mostRecent().args[0]).toEqual('veryDistinctSuchIdVeryWow');
+    expect(window.mixpanel.people.identify).toHaveBeenCalled();
+  });
+
+});