4.4.2

* feat(http): add patch request support (#2052)

* feat(http): add "disableRedirect" support (#2022)

* fix(http): remove obsolete "validateDomainName" function (#2053)

.github/ISSUE_TEMPLATE.md

@@ -1,7 +1,7 @@
 **I'm submitting a ...**  (check one with "x")
 [ ] bug report
 [ ] feature request
-<!-- Please do not submit support requests here, use one of these channels: https://forum.ionicframework.com/ or https://ionicworldwide.herokuapp.com/ -->
+[ ] support request => Please do not submit support requests here, use one of these channels: https://forum.ionicframework.com/ or https://ionicworldwide.herokuapp.com/
 
 **Current behavior:**
 <!-- Describe how the bug manifests. -->
@@ -21,8 +21,8 @@ insert any relevant code here
 **Other information:**
 <!-- List any other information that is relevant to your issue. Stack traces, related issues, suggestions on how to fix, Stack Overflow links, forum links, etc. -->
 
-**package.json info:**
+**Ionic info:** (run `ionic info` from a terminal/cmd prompt and paste output below):
 
-```json
-insert the content here
+```
+insert the output from ionic info here
 ```

CHANGELOG.md

@@ -1,3 +1,67 @@
+<a name="4.4.1"></a>
+## [4.4.1](https://github.com/ionic-team/ionic-native/compare/v4.4.0...v4.4.1) (2017-11-13)
+
+
+
+<a name="4.4.0"></a>
+# [4.4.0](https://github.com/ionic-team/ionic-native/compare/v4.3.3...v4.4.0) (2017-11-09)
+
+
+### Features
+
+* **google-maps:** accept own properties for `addMarker()` and others ([#2093](https://github.com/ionic-team/ionic-native/issues/2093)) ([196be02](https://github.com/ionic-team/ionic-native/commit/196be02))
+* **http:** add support for new methods ([#2054](https://github.com/ionic-team/ionic-native/issues/2054)) ([d96d3ee](https://github.com/ionic-team/ionic-native/commit/d96d3ee))
+
+
+
+<a name="4.3.3"></a>
+## [4.3.3](https://github.com/ionic-team/ionic-native/compare/v4.3.2...v4.3.3) (2017-11-01)
+
+
+### Bug Fixes
+
+* **google-maps:** HtmlInfoWindow should extend BaseClass [#2034](https://github.com/ionic-team/ionic-native/issues/2034)  ([#2035](https://github.com/ionic-team/ionic-native/issues/2035)) ([ce6e412](https://github.com/ionic-team/ionic-native/commit/ce6e412))
+
+
+
+<a name="4.3.2"></a>
+## [4.3.2](https://github.com/ionic-team/ionic-native/compare/4.3.2...v4.3.2) (2017-10-18)
+
+
+
+<a name="4.3.2"></a>
+## [4.3.2](https://github.com/ionic-team/ionic-native/compare/4.3.1...4.3.2) (2017-10-17)
+
+
+### Bug Fixes
+
+* **google-maps:** remove type from GoogleMapsEvent constant ([4639bf9](https://github.com/ionic-team/ionic-native/commit/4639bf9))
+
+
+### Features
+
+* **pro:** support corova-plugin-ionic v2.0.0 ([975f08b](https://github.com/ionic-team/ionic-native/commit/975f08b))
+
+
+
+<a name="4.3.1"></a>
+## [4.3.1](https://github.com/ionic-team/ionic-native/compare/v4.3.0...4.3.1) (2017-10-06)
+
+
+### Bug Fixes
+
+* **BLE:** make readRSSI() not static ([#2011](https://github.com/ionic-team/ionic-native/issues/2011)) ([363b41e](https://github.com/ionic-team/ionic-native/commit/363b41e))
+* **google-maps:** various fixed introduced in previous release ([#2024](https://github.com/ionic-team/ionic-native/issues/2024)) ([6ca5bea](https://github.com/ionic-team/ionic-native/commit/6ca5bea))
+* **onesignal:** fix property name ([#2019](https://github.com/ionic-team/ionic-native/issues/2019)) ([30ed33a](https://github.com/ionic-team/ionic-native/commit/30ed33a))
+
+
+### Features
+
+* **pro:** Add support for Ionic Pro by incorporating cordova-plugin-ionic ([465d551](https://github.com/ionic-team/ionic-native/commit/465d551))
+* **regula-document-reader:** separate initialization and scanning, add android ([#2013](https://github.com/ionic-team/ionic-native/issues/2013)) ([2179699](https://github.com/ionic-team/ionic-native/commit/2179699))
+
+
+
 <a name="4.3.0"></a>
 # [4.3.0](https://github.com/ionic-team/ionic-native/compare/v4.2.1...v4.3.0) (2017-09-27)
 
@@ -1789,13 +1853,13 @@ The whole implementation has changed now. You must update your code.
 * **geolocation:** call correct clearFunction ([9e86a40](https://github.com/ionic-team/ionic-native/commit/9e86a40))
 * **plugin:** return originalMethod return value ([240f0f8](https://github.com/ionic-team/ionic-native/commit/240f0f8))
 * **plugin:** use call for id based clearFunction ([c2fdf39](https://github.com/ionic-team/ionic-native/commit/c2fdf39))
-* datepicker plugin, pluginref, and [@Cordova](https://github.com/Cordova) wrapper ([499ead3](https://github.com/ionic-team/ionic-native/commit/499ead3))
+* datepicker plugin, pluginref, and @Cordova wrapper ([499ead3](https://github.com/ionic-team/ionic-native/commit/499ead3))
 
 
 ### Features
 
 * **DatePicker:** Added DatePicker ([5afa58f](https://github.com/ionic-team/ionic-native/commit/5afa58f))
-* **plugin:** add sync option to [@Cordova](https://github.com/Cordova) for sync functions ([17e3827](https://github.com/ionic-team/ionic-native/commit/17e3827))
+* **plugin:** add sync option to @Cordova for sync functions ([17e3827](https://github.com/ionic-team/ionic-native/commit/17e3827))
 * **plugin:** call clearFunction with original fn args ([8f27fc9](https://github.com/ionic-team/ionic-native/commit/8f27fc9))
 * add app version plugin ([20cb01f](https://github.com/ionic-team/ionic-native/commit/20cb01f))
 * add app version plugin ([8b78521](https://github.com/ionic-team/ionic-native/commit/8b78521))

DEVELOPER.md

@@ -209,4 +209,13 @@ Example:
 someMethod(): Promise<any> {
   // anything here will only run if the plugin is available
 }
+```
+
+#### CordovaFunctionOverride
+Wrap a stub function in a call to a Cordova plugin, checking if both Cordova and the required plugin are installed.
+
+Example:
+```ts
+@CordovaFunctionOverride()
+someMethod(): Observable<any> { return; }
 ```

package.json

@@ -1,21 +1,21 @@
 {
   "name": "ionic-native",
-  "version": "4.3.0",
+  "version": "4.4.2",
   "description": "Native plugin wrappers for Cordova and Ionic with TypeScript, ES6+, Promise and Observable support",
   "homepage": "https://ionicframework.com/",
   "author": "Ionic Team <hi@ionic.io> (https://ionic.io)",
   "license": "MIT",
   "devDependencies": {
-    "@angular/compiler": "4.1.3",
-    "@angular/compiler-cli": "4.1.3",
-    "@angular/core": "4.1.3",
+    "@angular/compiler": "4.4.4",
+    "@angular/compiler-cli": "4.4.4",
+    "@angular/core": "4.4.4",
     "@types/cordova": "0.0.34",
-    "@types/jasmine": "^2.5.51",
-    "@types/node": "^7.0.27",
+    "@types/jasmine": "^2.6.3",
+    "@types/node": "^8.0.50",
     "canonical-path": "0.0.2",
     "child-process-promise": "2.2.1",
-    "conventional-changelog-cli": "1.3.1",
-    "cpr": "2.0.2",
+    "conventional-changelog-cli": "1.3.4",
+    "cpr": "2.0.0",
     "cz-conventional-changelog": "2.0.0",
     "decamelize": "1.2.0",
     "dgeni": "0.4.7",
@@ -39,12 +39,12 @@
     "q": "1.5.0",
     "queue": "4.2.1",
     "rimraf": "2.6.1",
-    "rxjs": "5.4.0",
+    "rxjs": "5.5.2",
     "semver": "5.3.0",
     "tslint": "3.15.1",
     "tslint-ionic-rules": "0.0.8",
-    "typescript": "2.3.3",
-    "zone.js": "0.8.12"
+    "typescript": "~2.4.2",
+    "zone.js": "0.8.18"
   },
   "scripts": {
     "start": "npm run test:watch",

scripts/docs/dgeni-readmes-config.js

@@ -41,7 +41,7 @@ module.exports = currentVersion => {
         docTypes: ['class'],
         getOutputPath: doc => doc.originalModule.replace(config.pluginDir + '/', '')
           .replace('/plugins', '')
-          .replace('/index', '/README.md')
+          .replace(/\/index$/, '/README.md')
       }];
 
     })

scripts/templates/wrap-min.tmpl

@@ -1,9 +1,23 @@
-import { Plugin, IonicNativePlugin } from '@ionic-native/core';
+/**
+ * This is a template for new plugin wrappers
+ *
+ * TODO:
+ * - Add/Change information below
+ * - Document usage (importing, executing main functionality)
+ * - Remove any imports that you are not using
+ * - Add this file to /src/index.ts (follow style of other plugins)
+ * - Remove all the comments included in this template, EXCEPT the @Plugin wrapper docs and any other docs you added
+ * - Remove this note
+ *
+ */
 import { Injectable } from '@angular/core';
+import { Plugin, Cordova, CordovaProperty, CordovaInstance, InstanceProperty, IonicNativePlugin } from '@ionic-native/core';
+import { Observable } from 'rxjs/Observable';
 
 /**
  * @name {{ Plugin_Name }}
  * @description
+ * This plugin does something
  *
  * @usage
  * ```typescript
@@ -15,16 +29,33 @@ import { Injectable } from '@angular/core';
  * ...
  *
  *
+ * this.{{ pluginName }}.functionName('Hello', 123)
+ *   .then((res: any) => console.log(res))
+ *   .catch((error: any) => console.error(error));
+ *
  * ```
  */
 @Plugin({
   pluginName: '{{ PluginName }}',
-  plugin: '',
-  pluginRef: '',
-  repo: '',
-  platforms: []
+  plugin: '', // npm package name, example: cordova-plugin-camera
+  pluginRef: '', // the variable reference to call the plugin, example: navigator.geolocation
+  repo: '', // the github repository URL for the plugin
+  install: '', // OPTIONAL install command, in case the plugin requires variables
+  installVariables: [], // OPTIONAL the plugin requires variables
+  platforms: [] // Array of platforms supported, example: ['Android', 'iOS']
 })
 @Injectable()
 export class {{ PluginName }} extends IonicNativePlugin {
 
+  /**
+   * This function does something
+   * @param arg1 {string} Some param to configure something
+   * @param arg2 {number} Another param to configure something
+   * @return {Promise<any>} Returns a promise that resolves when something happens
+   */
+  @Cordova()
+  functionName(arg1: string, arg2: number): Promise<any> {
+    return; // We add return; here to avoid any IDE / Compiler errors
+  }
+
 }

scripts/templates/wrap.tmpl

@@ -40,8 +40,9 @@ import { Observable } from 'rxjs/Observable';
   plugin: '', // npm package name, example: cordova-plugin-camera
   pluginRef: '', // the variable reference to call the plugin, example: navigator.geolocation
   repo: '', // the github repository URL for the plugin
-  platforms: [], // Array of platforms supported, example: ['Android', 'iOS']
   install: '', // OPTIONAL install command, in case the plugin requires variables
+  installVariables: [], // OPTIONAL the plugin requires variables
+  platforms: [] // Array of platforms supported, example: ['Android', 'iOS']
 })
 @Injectable()
 export class {{ PluginName }} extends IonicNativePlugin {

src/@ionic-native/core/decorators.ts

@@ -105,17 +105,6 @@ export interface CordovaCheckOptions {
   observable?: boolean;
 }
 
-export interface CordovaFiniteObservableOptions extends CordovaOptions {
-  /**
-   * Function that gets a result returned from plugin's success callback, and decides whether it is last value and observable should complete.
-   */
-  resultFinalPredicate?: (result: any) => boolean;
-  /**
-   * Function that gets called after resultFinalPredicate, and removes service data that indicates end of stream from the result.
-   */
-  resultTransform?: (result: any) => any;
-}
-
 /**
  * @private
  */
@@ -167,7 +156,6 @@ export function CordovaCheck(opts: CordovaCheckOptions = {}) {
   };
 }
 
-
 /**
  * @private
  *
@@ -323,39 +311,3 @@ export function CordovaFunctionOverride(opts: any = {}) {
   };
 }
 
-
-/**
- * @private
- *
- * Wraps method that returns an observable that can be completed. Provided opts.resultFinalPredicate dictates when the observable completes.
- *
- */
-export function CordovaFiniteObservable(opts: CordovaFiniteObservableOptions = {}) {
-  if (opts.observable === false) {
-    throw new Error('CordovaFiniteObservable decorator can only be used on methods that returns observable. Please provide correct option.');
-  }
-  opts.observable = true;
-  return (target: Object, methodName: string, descriptor: TypedPropertyDescriptor<any>) => {
-    return {
-      value: function(...args: any[]) {
-        let wrappedObservable: Observable<any> = wrap(this, methodName, opts).apply(this, args);
-        return new Observable<any>((observer) => {
-          let wrappedSubscription = wrappedObservable.subscribe({
-            next: (x) => {
-              observer.next(opts.resultTransform ? opts.resultTransform(x) : x);
-              if (opts.resultFinalPredicate && opts.resultFinalPredicate(x)) {
-                observer.complete();
-              }
-            },
-            error: (err) => { observer.error(err); },
-            complete: () => { observer.complete(); }
-          });
-          return () => {
-            wrappedSubscription.unsubscribe();
-          };
-        });
-      },
-      enumerable: true
-    };
-  };
-}

src/@ionic-native/plugins/ble/index.ts

@@ -441,7 +441,7 @@ export class BLE extends IonicNativePlugin {
    *@returns {Promise<any>}
    */
   @Cordova()
-  static readRSSI(
+  readRSSI(
     deviceId: string,
   ): Promise<any> { return; }
 }

src/@ionic-native/plugins/couchbase-lite/index.ts

@@ -24,6 +24,7 @@ import { Injectable } from '@angular/core';
  * getUrl() {
  *      return this.url;
  * }
+ * // DATABASES //
  * createDatabase(database_name:string) {
  *      let url = this.getUrl();
  *      url = url+database_name;
@@ -34,7 +35,6 @@ import { Injectable } from '@angular/core';
  *           return Observable.throw(error.json() || 'Couchbase Lite error');
  *         })
  *  }
- * 
  * deleteDatabase(database_name:string) {
  *      let url = this.getUrl();
  *      url = url+database_name;
@@ -58,8 +58,6 @@ import { Injectable } from '@angular/core';
  * }
  *
  *
- *
- *
  * ```
  */
 @Plugin({

src/@ionic-native/plugins/firebase/index.ts

@@ -71,10 +71,10 @@ export class Firebase extends IonicNativePlugin {
 
   /**
  * Check permission to receive push notifications
- * @return {Promise<any>}
+ * @return {Promise<{isEnabled: boolean}>}
  */
   @Cordova()
-  hasPermission(): Promise<any> { return; }
+  hasPermission(): Promise<{isEnabled: boolean}> { return; }
 
   /**
    * Set icon badge number. Set to 0 to clear the badge.

src/@ionic-native/plugins/geolocation/index.ts

@@ -153,6 +153,8 @@ export interface GeolocationOptions {
   plugin: 'cordova-plugin-geolocation',
   pluginRef: 'navigator.geolocation',
   repo: 'https://github.com/apache/cordova-plugin-geolocation',
+  install: 'ionic cordova plugin add cordova-plugin-geolocation --variable GEOLOCATION_USAGE_DESCRIPTION="To locate you"',
+  installVariables: ['GEOLOCATION_USAGE_DESCRIPTION'],
   platforms: ['Amazon Fire OS', 'Android', 'BlackBerry 10', 'Browser', 'Firefox OS', 'iOS', 'Ubuntu', 'Windows', 'Windows Phone']
 })
 @Injectable()

src/@ionic-native/plugins/http/index.ts

@@ -113,6 +113,13 @@ export class HTTP extends IonicNativePlugin {
   @Cordova({ sync: true })
   removeCookies(url: string, cb: () => void): void { }
 
+  /**
+   * Disable following redirects automatically
+   * @param disable {boolean} Set to true to disable following redirects automatically
+   */
+  @Cordova({ sync: true })
+  disableRedirect(disable: boolean): void { }
+
   /**
    * Set request timeout
    * @param timeout {number} The timeout in seconds. Default 60
@@ -140,14 +147,6 @@ export class HTTP extends IonicNativePlugin {
   @Cordova()
   acceptAllCerts(accept: boolean): Promise<void> { return; }
 
-  /**
-   * Whether or not to validate the domain name in the certificate. This defaults to true.
-   * @param validate {boolean} Set to true to validate
-   * @returns {Promise<void>} returns a promise that will resolve on success, and reject on failure
-   */
-  @Cordova()
-  validateDomainName(validate: boolean): Promise<void> { return; }
-
   /**
    * Make a POST request
    * @param url {string} The url to send the request to
@@ -178,6 +177,16 @@ export class HTTP extends IonicNativePlugin {
   @Cordova()
   put(url: string, body: any, headers: any): Promise<HTTPResponse> { return; }
 
+  /**
+   * Make a PATCH request
+   * @param url {string} The url to send the request to
+   * @param body {Object} The body of the request
+   * @param headers {Object} The headers to set for this request
+   * @returns {Promise<HTTPResponse>} returns a promise that resolve on success, and reject on failure
+   */
+  @Cordova()
+  patch(url: string, body: any, headers: any): Promise<HTTPResponse> { return; }
+
   /**
    * Make a DELETE request
    * @param url {string} The url to send the request to

src/@ionic-native/plugins/onesignal/index.ts

@@ -165,7 +165,7 @@ export interface OSNotificationPayload {
   /**
    * URL to open when opening the notification.
    */
-  launchUrl?: string;
+  launchURL?: string;
   /**
    * Sound resource to play when the notification is shown.
    */
@@ -301,7 +301,8 @@ export enum OSActionType {
  * The OneSignal plugin is an client implementation for using the [OneSignal](https://onesignal.com/) Service.
  * OneSignal is a simple implementation for delivering push notifications.
  *
- * Requires Cordova plugin: `onesignal-cordova-plugin`. For more info, please see the [OneSignal Cordova Docs](https://documentation.onesignal.com/docs/phonegap-sdk-installation).
+ * Please view the official [OneSignal Ionic SDK Installation](https://documentation.onesignal.com/docs/ionic-sdk-setup) guide
+ * for more information.
  *
  * #### Icons
  * If you want to use generated icons with command `ionic cordova resources`:

src/@ionic-native/plugins/phonegap-local-notification/index.ts

@@ -61,7 +61,7 @@ export interface LocalNotificationOptions {
  * import { PhonegapLocalNotification } from '@ionic-native/phonegap-local-notification';
  *
  *
- * constructor(private localNotification: PhonegapLocalNotifications) { }
+ * constructor(private localNotification: PhonegapLocalNotification) { }
  *
  * ...
  *

src/@ionic-native/plugins/photo-library/index.ts

@@ -1,7 +1,54 @@
-import { Plugin, Cordova, CordovaFiniteObservable, IonicNativePlugin } from '@ionic-native/core';
+import { Plugin, Cordova, IonicNativePlugin, CordovaOptions, wrap } from '@ionic-native/core';
 import { Observable } from 'rxjs/Observable';
+import { Observer } from 'rxjs/Observer';
 import { Injectable } from '@angular/core';
 
+/**
+ * @hidden
+ */
+export interface CordovaFiniteObservableOptions extends CordovaOptions {
+  /**
+   * Function that gets a result returned from plugin's success callback, and decides whether it is last value and observable should complete.
+   */
+  resultFinalPredicate?: string;
+  /**
+   * Function that gets called after resultFinalPredicate, and removes service data that indicates end of stream from the result.
+   */
+  resultTransform?: string;
+}
+
+/**
+ * @hidden
+ *
+ * Wraps method that returns an observable that can be completed. Provided opts.resultFinalPredicate dictates when the observable completes.
+ */
+export function CordovaFiniteObservable(opts: CordovaFiniteObservableOptions = {}) {
+  opts.observable = true;
+  return (target: Object, methodName: string, descriptor: TypedPropertyDescriptor<any>) => {
+    return {
+      value: function(...args: any[]) {
+        const wrappedObservable: Observable<any> = wrap(this, methodName, opts).apply(this, args);
+        return new Observable<any>((observer: Observer<any>) => {
+          const wrappedSubscription = wrappedObservable.subscribe({
+            next: (x: any) => {
+              observer.next(opts.resultTransform ? x[opts.resultTransform] : x);
+              if (opts.resultFinalPredicate && x[opts.resultFinalPredicate]) {
+                observer.complete();
+              }
+            },
+            error: (err: any) => { observer.error(err); },
+            complete: () => { observer.complete(); }
+          });
+          return () => {
+            wrappedSubscription.unsubscribe();
+          };
+        });
+      },
+      enumerable: true
+    };
+  };
+}
+
 /**
  * @name Photo Library
  * @description
@@ -58,8 +105,8 @@ export class PhotoLibrary extends IonicNativePlugin {
    */
   @CordovaFiniteObservable({
     callbackOrder: 'reverse',
-    resultFinalPredicate: (result: { isLastChunk: boolean }) => { return result.isLastChunk; },
-    resultTransform: (result: { library: LibraryItem[] }) => { return result.library; },
+    resultFinalPredicate: 'isLastChunk',
+    resultTransform: 'library'
   })
   getLibrary(options?: GetLibraryOptions): Observable<LibraryItem[]> { return; }
 
@@ -69,7 +116,7 @@ export class PhotoLibrary extends IonicNativePlugin {
    * @return { Promise<void>} Returns a promise that resolves when permissions are granted, and fails when not.
    */
   @Cordova({
-    callbackOrder: 'reverse',
+    callbackOrder: 'reverse'
   })
   requestAuthorization(options?: RequestAuthorizationOptions): Promise<void> { return; }
 
@@ -78,7 +125,7 @@ export class PhotoLibrary extends IonicNativePlugin {
    * @return {Promise<AlbumItem[]>} Resolves to list of albums.
    */
   @Cordova({
-    callbackOrder: 'reverse',
+    callbackOrder: 'reverse'
   })
   getAlbums(): Promise<AlbumItem[]> { return; }
 

src/@ionic-native/plugins/photo-viewer/index.ts

@@ -1,5 +1,13 @@
 import { Injectable } from '@angular/core';
 import { Plugin, Cordova, IonicNativePlugin } from '@ionic-native/core';
+
+export interface PhotoViewerOptions {
+  /**
+   * Set to false to disable the share button (Android only). Default: true
+   */
+  share?: boolean;
+}
+
 /**
  * @name Photo Viewer
  * @description This plugin can display your image in full screen with the ability to pan, zoom, and share the image.
@@ -29,8 +37,8 @@ export class PhotoViewer extends IonicNativePlugin {
    * Shows an image in full screen
    * @param url {string} URL or path to image
    * @param title {string}
-   * @param options {any}
+   * @param options {PhotoViewerOptions}
    */
   @Cordova({sync: true})
-  show(url: string, title?: string, options?: {share?: boolean}): void { }
+  show(url: string, title?: string, options?: PhotoViewerOptions): void { }
 }

src/@ionic-native/plugins/pro/index.ts

@@ -0,0 +1,173 @@
+import { Injectable } from '@angular/core';
+import { Plugin, Cordova, CordovaInstance, IonicNativePlugin } from '@ionic-native/core';
+import { Observable } from 'rxjs/Observable';
+
+/**
+ * Information about the currently running app
+ */
+export interface AppInfo {
+  platform: string;
+  platformVersion: string;
+  version: string;
+  bundleName: string;
+  bundleVersion: string;
+}
+
+/**
+ * Information about the current live update
+ */
+export interface DeployInfo {
+  deploy_uuid: string;
+  channel: string;
+  binary_version: string;
+}
+
+/**
+ * Object for manually configuring deploy
+ */
+export interface DeployConfig {
+  appId?: string;
+  host?: string;
+  channel?: string;
+}
+
+/**
+ * @hidden
+ */
+export class ProDeploy {
+
+  constructor(private _objectInstance: any) { }
+
+  /**
+   * Re-initialize Deploy plugin with a new App ID and host.  Not used in most cases.
+   * @param config A valid Deploy config object
+   */
+  @CordovaInstance()
+  init(config: DeployConfig): Promise<any> { return; }
+
+  /**
+   * Check a channel for an available update
+   * @return {Promise<string>} Resolves with 'true' or 'false', or rejects with an error.
+   */
+  @CordovaInstance({
+    observable: true
+  })
+  check(): Promise<string> { return; }
+
+  /**
+   * Download an available version
+   * @return {Observable<any>} Updates with percent completion, or errors with a message.
+   */
+  @CordovaInstance({
+    observable: true
+  })
+  download(): Observable<any> { return; }
+
+  /**
+   * Unzip the latest downloaded version
+   * @return {Observable<any>} Updates with percent completion, or errors with a message.
+   */
+  @CordovaInstance()
+  extract(): Observable<any> { return; }
+
+  /**
+   * Reload app with the deployed version
+   */
+  @CordovaInstance()
+  redirect(): Promise<any> { return; }
+
+  /**
+   * Get info about the version running on the device
+   * @return {Promise<DeployInfo>} Information about the current version running on the app.
+   */
+  @CordovaInstance()
+  info(): Promise<DeployInfo> { return; }
+
+  /**
+   * List versions stored on the device
+   */
+  @CordovaInstance()
+  getVersions(): Promise<any> { return; }
+
+  /**
+   * Delete a version stored on the device by UUID
+   * @param version A version UUID
+   */
+  @CordovaInstance()
+  deleteVersion(version: string): Promise<any> { return; }
+}
+
+/**
+ * @name Pro
+ * @description
+ * This plugin enables Ionic Pro services like live updates and error monitoring
+ *
+ * @usage
+ * ```typescript
+ * import { Pro, AppInfo, DeployInfo } from '@ionic-native/pro';
+ *
+ *
+ * constructor(private pro: Pro) { }
+ * 
+ * // Get app info
+ * this.pro.getAppInfo().then((res: AppInfo) => {
+ *   console.log(res)
+ * })
+ * 
+ * // Get live update info
+ * this.pro.deploy.info().then((res: DeployInfo) => {
+ *   console.log(res)
+ * })
+ * ``` 
+ */
+@Plugin({
+  pluginName: 'Pro',
+  plugin: 'cordova-plugin-ionic',
+  pluginRef: 'IonicCordova',
+  repo: 'https://github.com/ionic-team/cordova-plugin-ionic',
+  platforms: ['Android', 'iOS'],
+  install: 'ionic cordova plugin add cordova-plugin-ionic --save --variable APP_ID="XXXXXXXX" --variable CHANNEL_NAME="Channel"'
+})
+@Injectable()
+export class Pro extends IonicNativePlugin {
+  /**
+   * Ionic Pro Deploy .js API.
+   */
+  deploy: ProDeploy = new ProDeploy(Pro.getPlugin().deploy);
+
+  /**
+   * Not yet implemented
+   * @return {Promise<any>} Returns a promise that resolves when something happens
+   */
+  @Cordova()
+  enableCrashLogging(): Promise<any> { return; }
+
+  /**
+   * Not yet implemented
+   * @return {Promise<any>} Returns a promise that resolves when something happens
+   */
+  @Cordova()
+  checkForPendingCrash(): Promise<any> { return; }
+
+  /**
+   * Not yet implemented
+   * @return {Promise<any>} Returns a promise that resolves when something happens
+   */
+  @Cordova()
+  loadPendingCrash(): Promise<any> { return; }
+
+  /**
+   * Not yet implemented
+   * @return {Promise<any>} Returns a promise that resolves when something happens
+   */
+  @Cordova()
+  forceCrash(): Promise<any> { return; }
+
+  /**
+   * Get information about the currently running app
+   * @return {Promise<any>} Returns a promise that resolves with current app info
+   */
+  @Cordova()
+  getAppInfo(): Promise<AppInfo> { return; }
+}
+

src/@ionic-native/plugins/regula-document-reader/index.ts

@@ -13,7 +13,8 @@ import { Plugin, Cordova, IonicNativePlugin } from '@ionic-native/core';
  * import { RegulaDocumentReader } from '@ionic-native/regula-document-reader';
  *
  * let license; // read regula.license file
- * RegulaDocumentReader.scanDocument(license).then((result) => {
+ * RegulaDocumentReader.initReader(license); // initialize reader
+ * RegulaDocumentReader.scanDocument().then((result) => {
  * 		// read result
  * })
  * ```
@@ -23,17 +24,23 @@ import { Plugin, Cordova, IonicNativePlugin } from '@ionic-native/core';
   plugin: 'cordova-plugin-documentreader',
   pluginRef: 'DocumentReader',
   repo: 'https://github.com/regulaforensics/cordova-plugin-documentreader.git',
-  platforms: ['iOS'],
+  platforms: ['iOS', 'Android'],
   install: 'ionic plugin add cordova-plugin-documentreader --variable CAMERA_USAGE_DESCRIPTION="To take photo"',
 })
 @Injectable()
 export class RegulaDocumentReader extends IonicNativePlugin {
 
   /**
-   * Run the scanner
+   * Initialize the scanner
    * @param license {any} License data
+   */
+  @Cordova()
+  initReader(license: any): void {}
+
+  /**
+   * Run the scanner
    * @return {Promise<string[]>} Returns a promise that resolves when results was got, and fails when not
    */
   @Cordova()
-  scanDocument(license: any): Promise<string[]> { return; }
+  scanDocument(): Promise<string[]> { return; }
 }