Merge pull request #110 from cmanou/email-plugin

feat(plugin): add email composer plugin

src/index.ts

@@ -25,6 +25,7 @@ import {DeviceMotion} from './plugins/devicemotion';
 import {DeviceOrientation} from './plugins/deviceorientation';
 import {Diagnostic} from './plugins/diagnostic';
 import {Dialogs} from './plugins/dialogs';
+import {EmailComposer} from './plugins/emailcomposer';
 import {Facebook} from './plugins/facebook';
 import {File} from './plugins/file';
 import {Flashlight} from './plugins/flashlight';
@@ -70,6 +71,7 @@ export {
   DeviceOrientation,
   Dialogs,
   Diagnostic,
+  EmailComposer,
   Facebook,
   File,
   Flashlight,
@@ -119,6 +121,7 @@ window['IonicNative'] = {
   DeviceOrientation: DeviceOrientation,
   Dialogs: Dialogs,
   Diagnostic: Diagnostic,
+  EmailComposer: EmailComposer,
   Facebook: Facebook,
   File: File,
   Flashlight: Flashlight,

src/plugins/emailcomposer.ts

@@ -0,0 +1,99 @@
+import {Plugin, Cordova} from './plugin';
+
+declare var cordova;
+
+/**
+ * Email object for Opening Email Composer
+ */
+export interface email {
+  app?: string,
+  to: string | Array<string>,
+  cc: string | Array<string>,
+  bcc: string | Array<string>,
+  attachments: Array<any>,
+  subject: string,
+  body: string,
+  isHtml: boolean
+}
+
+/**
+ * @name Email Composer
+ * @description
+ *
+ * Requires Cordova plugin: cordova-plugin-email-composer. For more info, please see the [Email Composer plugin docs](https://github.com/katzer/cordova-plugin-email-composer).
+ *
+ * @usage
+ * ```ts
+ * import {EmailComposer} from 'ionic-native';
+ *
+ * 
+ * EmailComposer.isAvailable().then((available) =>{
+ *  if(available) {
+ *    //Now we know we can send
+ *  }
+ * });
+ *
+ * let email = {
+ *   to: 'max@mustermann.de',
+ *   cc: 'erika@mustermann.de',
+ *   bcc: ['john@doe.com', 'jane@doe.com'],
+ *   attachments: [
+ *     'file://img/logo.png',
+ *     'res://icon.png',
+ *     'base64:icon.png//iVBORw0KGgoAAAANSUhEUg...',
+ *     'file://README.pdf'
+ *   ],
+ *   subject: 'Cordova Icons',
+ *   body: 'How are you? Nice greetings from Leipzig',
+ *   isHtml: true
+ * };
+ *
+ * // Send a text message using default options
+ * EmailComposer.send(email);
+ *
+ * ```
+ */
+@Plugin({
+  plugin: 'cordova-plugin-email-composer',
+  pluginRef: 'cordova.plugins.email',
+  repo: 'https://github.com/katzer/cordova-plugin-email-composer.git',
+  platforms: ['Android', 'iOS', 'Windows Phone 8']
+})
+export class EmailComposer {
+  
+   /**
+   * Verifies if sending emails is supported on the device.
+   * 
+   * @param app {string?} An optional app id or uri scheme. Defaults to mailto.
+   * @param scope {any?} An optional scope for the promise
+   * @returns {Promise<boolean>} Resolves promise with boolean whether EmailComposer is available
+   */
+  static isAvailable (app? : string, scope? : any) : Promise<boolean> {
+    return new Promise<boolean>((resolve, reject) => {
+      cordova.plugins.email.isAvailable(app, resolve, scope);
+    });
+  }
+
+  /**
+   * Adds a new mail app alias.
+   *
+   * @param alias {string} The alias name
+   * @param packageName {string} The package name
+   */
+  @Cordova()
+  static addAlias(alias : string, packageName : string): void {}
+  
+  /**
+   * Displays the email composer pre-filled with data.
+   * 
+   * @param email {email} Email
+   * @param scope {any?} An optional scope for the promise
+   * @returns {Promise<any>} Resolves promise when the EmailComposer has been opened
+   */
+  @Cordova({
+    successIndex: 1,
+    errorIndex: 3
+  })
+  static open(email : email, scope? : any) : Promise<any> {return}
+
+}