cordova.plugins.diagnostic 6.0.4

package/www/ios/diagnostic.bluetooth.js

@@ -0,0 +1,127 @@
+/* globals cordova, require, exports, module */
+
+/**
+ *  Diagnostic Bluetooth plugin for iOS
+ *
+ *  Copyright (c) 2015 Working Edge Ltd.
+ *  Copyright (c) 2012 AVANTIC ESTUDIO DE INGENIEROS
+ **/
+var Diagnostic_Bluetooth = (function(){
+    /***********************
+     *
+     * Internal properties
+     *
+     *********************/
+    var Diagnostic_Bluetooth = {};
+
+    var Diagnostic = require("cordova.plugins.diagnostic.Diagnostic");
+
+    /********************
+     *
+     * Public properties
+     *
+     ********************/
+
+    Diagnostic.bluetoothState = Diagnostic_Bluetooth.bluetoothState = {
+        "UNKNOWN": "unknown",
+        "RESETTING": "resetting",
+        "UNSUPPORTED": "unsupported",
+        "UNAUTHORIZED": "unauthorized",
+        "POWERED_OFF": "powered_off",
+        "POWERED_ON": "powered_on"
+    };
+
+
+
+    /********************
+     *
+     * Internal functions
+     *
+     ********************/
+
+    /*****************************
+     *
+     * Protected member functions
+     *
+     ****************************/
+    Diagnostic_Bluetooth._onBluetoothStateChange = function(){};
+
+
+    /**********************
+     *
+     * Public API functions
+     *
+     **********************/
+
+    /**
+     * Checks if the device has Bluetooth LE capabilities and if so that Bluetooth is switched on
+     *
+     * @param {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single boolean parameter which is TRUE if device has Bluetooth LE and Bluetooth is switched on.
+     * @param {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Bluetooth.isBluetoothAvailable = function(successCallback, errorCallback) {
+        return cordova.exec(Diagnostic._ensureBoolean(successCallback),
+            errorCallback,
+            'Diagnostic_Bluetooth',
+            'isBluetoothAvailable',
+            []);
+    };
+
+    /**
+     * Returns the state of Bluetooth LE on the device.
+     *
+     * @param {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single string parameter which indicates the Bluetooth state as a constant in `cordova.plugins.diagnostic.bluetoothState`.
+     * @param {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Bluetooth.getBluetoothState = function(successCallback, errorCallback) {
+        return cordova.exec(successCallback,
+            errorCallback,
+            'Diagnostic_Bluetooth',
+            'getBluetoothState',
+            []);
+    };
+
+
+    /**
+     * Registers a function to be called when a change in Bluetooth state occurs.
+     * Pass in a falsey value to de-register the currently registered function.
+     *
+     * @param {Function} successCallback - function call when a change in Bluetooth state occurs.
+     * This callback function is passed a single string parameter which indicates the Bluetooth state as a constant in `cordova.plugins.diagnostic.bluetoothState`.
+     */
+    Diagnostic_Bluetooth.registerBluetoothStateChangeHandler = function(successCallback){
+        Diagnostic_Bluetooth._onBluetoothStateChange = successCallback || function(){};
+        return cordova.exec(successCallback,
+            null,
+            'Diagnostic_Bluetooth',
+            'ensureBluetoothManager',
+            []);
+    };
+
+    /**
+     * Requests Bluetooth authorization for the application.
+     * The outcome of the authorization request can be determined by registering a handler using `registerBluetoothStateChangeHandler()`.
+     *
+     * @param {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is not passed any parameters.
+     * @param {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Bluetooth.requestBluetoothAuthorization = function(successCallback, errorCallback) {
+        return cordova.exec(
+            successCallback,
+            errorCallback,
+            'Diagnostic_Bluetooth',
+            'requestBluetoothAuthorization',
+            []);
+    };
+
+
+
+    return Diagnostic_Bluetooth;
+});
+module.exports = new Diagnostic_Bluetooth();

package/www/ios/diagnostic.calendar.js

@@ -0,0 +1,97 @@
+/* globals cordova, require, exports, module */
+
+/**
+ *  Diagnostic Calendar plugin for iOS
+ *
+ *  Copyright (c) 2015 Working Edge Ltd.
+ *  Copyright (c) 2012 AVANTIC ESTUDIO DE INGENIEROS
+ **/
+var Diagnostic_Calendar = (function(){
+    /***********************
+     *
+     * Internal properties
+     *
+     *********************/
+    var Diagnostic_Calendar = {};
+
+    var Diagnostic = require("cordova.plugins.diagnostic.Diagnostic");
+
+    /********************
+     *
+     * Public properties
+     *
+     ********************/
+    
+    /********************
+     *
+     * Internal functions
+     *
+     ********************/
+
+    /*****************************
+     *
+     * Protected member functions
+     *
+     ****************************/
+
+
+    /**********************
+     *
+     * Public API functions
+     *
+     **********************/
+    /**
+     * Checks if the application is authorized to use calendar.
+     *
+     * @param {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single boolean parameter which is TRUE if calendar is authorized for use.
+     * @param {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Calendar.isCalendarAuthorized = function(successCallback, errorCallback) {
+        return cordova.exec(Diagnostic._ensureBoolean(successCallback),
+            errorCallback,
+            'Diagnostic_Calendar',
+            'isCalendarAuthorized',
+            []);
+    };
+
+    /**
+     * Returns the calendar event authorization status for the application.
+     *
+     * @param {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single string parameter which indicates the authorization status as a constant in `cordova.plugins.diagnostic.permissionStatus`.
+     * @param {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Calendar.getCalendarAuthorizationStatus = function(successCallback, errorCallback) {
+        return cordova.exec(successCallback,
+            errorCallback,
+            'Diagnostic_Calendar',
+            'getCalendarAuthorizationStatus',
+            []);
+    };
+
+    /**
+     * Requests calendar event authorization for the application.
+     * Should only be called if authorization status is NOT_REQUESTED. Calling it when in any other state will have no effect.
+     *
+     * @param {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single string parameter indicating whether access to calendar was granted or denied:
+     * `cordova.plugins.diagnostic.permissionStatus.GRANTED` or `cordova.plugins.diagnostic.permissionStatus.DENIED_ALWAYS`
+     * @param {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Calendar.requestCalendarAuthorization = function(successCallback, errorCallback) {
+        return cordova.exec(function(isGranted){
+                successCallback(isGranted ? Diagnostic.permissionStatus.GRANTED : Diagnostic.permissionStatus.DENIED_ALWAYS);
+            },
+            errorCallback,
+            'Diagnostic_Calendar',
+            'requestCalendarAuthorization',
+            []);
+    };
+
+    return Diagnostic_Calendar;
+});
+module.exports = new Diagnostic_Calendar();

package/www/ios/diagnostic.camera.js

@@ -0,0 +1,212 @@
+/* globals cordova, require, exports, module */
+
+/**
+ *  Diagnostic Camera plugin for iOS
+ *
+ *  Copyright (c) 2015 Working Edge Ltd.
+ *  Copyright (c) 2012 AVANTIC ESTUDIO DE INGENIEROS
+ **/
+var Diagnostic_Camera = (function(){
+    /***********************
+     *
+     * Internal properties
+     *
+     *********************/
+    var Diagnostic_Camera = {};
+
+    var Diagnostic = require("cordova.plugins.diagnostic.Diagnostic");
+
+    /********************
+     *
+     * Public properties
+     *
+     ********************/
+    
+    /********************
+     *
+     * Internal functions
+     *
+     ********************/
+
+    function mapFromLegacyCameraApi() {
+        var params;
+        if (typeof arguments[0]  === "function") {
+            params = (arguments.length > 2 && typeof arguments[2]  === "object") ? arguments[2] : {};
+            params.successCallback = arguments[0];
+            if(arguments.length > 1 && typeof arguments[1]  === "function") {
+                params.errorCallback = arguments[1];
+            }
+        }else { // if (typeof arguments[0]  === "object")
+            params = arguments[0];
+        }
+        return params;
+    }
+
+    /*****************************
+     *
+     * Protected member functions
+     *
+     ****************************/
+
+
+    /**********************
+     *
+     * Public API functions
+     *
+     **********************/
+
+    /**
+     * Checks if camera is enabled for use.
+     * On iOS this returns true if both the device has a camera AND the application is authorized to use it.
+     *
+     * @param {Object} params - (optional) parameters:
+     *  - {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single boolean parameter which is TRUE if camera is present and authorized for use.
+     *  - {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Camera.isCameraAvailable = function(params) {
+        params = mapFromLegacyCameraApi.apply(this, arguments);
+
+        params.successCallback = params.successCallback || function(){};
+        return cordova.exec(Diagnostic._ensureBoolean(params.successCallback),
+            params.errorCallback,
+            'Diagnostic_Camera',
+            'isCameraAvailable',
+            []);
+    };
+
+    /**
+     * Checks if camera hardware is present on device.
+     *
+     * @param {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single boolean parameter which is TRUE if camera is present
+     * @param {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Camera.isCameraPresent = function(successCallback, errorCallback) {
+        return cordova.exec(Diagnostic._ensureBoolean(successCallback),
+            errorCallback,
+            'Diagnostic_Camera',
+            'isCameraPresent',
+            []);
+    };
+
+
+    /**
+     * Checks if the application is authorized to use the camera.
+     *
+     * @param {Object} params - (optional) parameters:
+     *  - {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single boolean parameter which is TRUE if camera is authorized for use.
+     *   - {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Camera.isCameraAuthorized = function(params) {
+        params = mapFromLegacyCameraApi.apply(this, arguments);
+
+        return cordova.exec(Diagnostic._ensureBoolean(params.successCallback),
+            params.errorCallback,
+            'Diagnostic_Camera',
+            'isCameraAuthorized',
+            []);
+    };
+
+    /**
+     * Returns the camera authorization status for the application.
+     *
+     * @param {Object} params - (optional) parameters:
+     *  - {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single string parameter which indicates the authorization status as a constant in `cordova.plugins.diagnostic.permissionStatus`.
+     *  - {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Camera.getCameraAuthorizationStatus = function(params) {
+        params = mapFromLegacyCameraApi.apply(this, arguments);
+
+        return cordova.exec(params.successCallback,
+            params.errorCallback,
+            'Diagnostic_Camera',
+            'getCameraAuthorizationStatus',
+            []);
+    };
+
+    /**
+     * Requests camera authorization for the application.
+     * Should only be called if authorization status is NOT_REQUESTED. Calling it when in any other state will have no effect.
+     *
+     * @param {Object} params - (optional) parameters:
+     * - {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single string parameter indicating whether access to the camera was granted or denied:
+     * `cordova.plugins.diagnostic.permissionStatus.GRANTED` or `cordova.plugins.diagnostic.permissionStatus.DENIED_ALWAYS`
+     * - {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Camera.requestCameraAuthorization = function(params){
+        params = mapFromLegacyCameraApi.apply(this, arguments);
+
+        params.successCallback = params.successCallback || function(){};
+        return cordova.exec(function(isGranted){
+                params.successCallback(isGranted ? Diagnostic.permissionStatus.GRANTED : Diagnostic.permissionStatus.DENIED_ALWAYS);
+            },
+            params.errorCallback,
+            'Diagnostic_Camera',
+            'requestCameraAuthorization',
+            []);
+    };
+
+    /**
+     * Checks if the application is authorized to use the Camera Roll in Photos app.
+     *
+     * @param {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single boolean parameter which is TRUE if access to Camera Roll is authorized.
+     * @param {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Camera.isCameraRollAuthorized = function(successCallback, errorCallback) {
+        return cordova.exec(Diagnostic._ensureBoolean(successCallback),
+            errorCallback,
+            'Diagnostic_Camera',
+            'isCameraRollAuthorized',
+            []);
+    };
+
+    /**
+     * Returns the authorization status for the application to use the Camera Roll in Photos app.
+     *
+     * @param {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single string parameter which indicates the authorization status as a constant in `cordova.plugins.diagnostic.permissionStatus`.
+     * @param {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Camera.getCameraRollAuthorizationStatus = function(successCallback, errorCallback) {
+        return cordova.exec(successCallback,
+            errorCallback,
+            'Diagnostic_Camera',
+            'getCameraRollAuthorizationStatus',
+            []);
+    };
+
+    /**
+     * Requests camera roll authorization for the application.
+     * Should only be called if authorization status is NOT_REQUESTED. Calling it when in any other state will have no effect.
+     *
+     * @param {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single string parameter indicating the new authorization status:
+     * `cordova.plugins.diagnostic.permissionStatus.GRANTED` or `cordova.plugins.diagnostic.permissionStatus.DENIED_ALWAYS`
+     * @param {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Camera.requestCameraRollAuthorization = function(successCallback, errorCallback) {
+        return cordova.exec(function(status){
+                successCallback(status === "authorized" ? Diagnostic.permissionStatus.GRANTED : Diagnostic.permissionStatus.DENIED_ALWAYS);
+            },
+            errorCallback,
+            'Diagnostic_Camera',
+            'requestCameraRollAuthorization',
+            []);
+    };
+
+    return Diagnostic_Camera;
+});
+module.exports = new Diagnostic_Camera();

package/www/ios/diagnostic.contacts.js

@@ -0,0 +1,98 @@
+/* globals cordova, require, exports, module */
+
+/**
+ *  Diagnostic Contacts plugin for iOS
+ *
+ *  Copyright (c) 2015 Working Edge Ltd.
+ *  Copyright (c) 2012 AVANTIC ESTUDIO DE INGENIEROS
+ **/
+var Diagnostic_Contacts = (function(){
+    /***********************
+     *
+     * Internal properties
+     *
+     *********************/
+    var Diagnostic_Contacts = {};
+
+    var Diagnostic = require("cordova.plugins.diagnostic.Diagnostic");
+
+    /********************
+     *
+     * Public properties
+     *
+     ********************/
+    
+    /********************
+     *
+     * Internal functions
+     *
+     ********************/
+
+    /*****************************
+     *
+     * Protected member functions
+     *
+     ****************************/
+
+
+    /**********************
+     *
+     * Public API functions
+     *
+     **********************/
+
+    /**
+     * Checks if the application is authorized to use contacts (address book).
+     *
+     * @param {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single boolean parameter which is TRUE if contacts is authorized for use.
+     * @param {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Contacts.isContactsAuthorized = function(successCallback, errorCallback) {
+        return cordova.exec(Diagnostic._ensureBoolean(successCallback),
+            errorCallback,
+            'Diagnostic_Contacts',
+            'isAddressBookAuthorized',
+            []);
+    };
+
+    /**
+     * Returns the contacts (address book) authorization status for the application.
+     *
+     * @param {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single string parameter which indicates the authorization status as a constant in `cordova.plugins.diagnostic.permissionStatus`.
+     * @param {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Contacts.getContactsAuthorizationStatus = function(successCallback, errorCallback) {
+        return cordova.exec(successCallback,
+            errorCallback,
+            'Diagnostic_Contacts',
+            'getAddressBookAuthorizationStatus',
+            []);
+    };
+
+    /**
+     * Requests contacts (address book) authorization for the application.
+     * Should only be called if authorization status is NOT_REQUESTED. Calling it when in any other state will have no effect.
+     *
+     * @param {Function} successCallback - The callback which will be called when operation is successful.
+     * This callback function is passed a single string parameter indicating whether access to contacts was granted or denied:
+     * `cordova.plugins.diagnostic.permissionStatus.GRANTED` or `cordova.plugins.diagnostic.permissionStatus.DENIED_ALWAYS`
+     * @param {Function} errorCallback -  The callback which will be called when operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic_Contacts.requestContactsAuthorization = function(successCallback, errorCallback) {
+        return cordova.exec(function(isGranted){
+                successCallback(isGranted ? Diagnostic.permissionStatus.GRANTED : Diagnostic.permissionStatus.DENIED_ALWAYS);
+            },
+            errorCallback,
+            'Diagnostic_Contacts',
+            'requestAddressBookAuthorization',
+            []);
+    };
+
+    return Diagnostic_Contacts;
+});
+module.exports = new Diagnostic_Contacts();