react-native-mailcore

react native bindings for https://github.com/MailCore/mailcore2

Stability status: alpha

Setup

• yarn add react-native-mailcore

• react-native link react-native-mailcore

• For ios, setup pods for your project. Go to ios directory in your project. See https://github.com/MailCore/mailcore2/blob/master/build-mac/README.md#cocoapods

  • If you havent setup pods for your project run pod init in your ios directory.

  • Add pod 'mailcore2-ios' to your Podfile. Example

      # Uncomment the next line to define a global platform for your project
      # platform :ios, '9.0'
    
      target 'BasicExample' do
        # Uncomment the next line if you're using Swift or would like to use dynamic frameworks
        # use_frameworks!
    
        # Pods for BasicExample
    
        pod 'mailcore2-ios'
    
        target 'BasicExampleTests' do
          inherit! :search_paths
          # Pods for testing
        end
    
      end
    
      target 'BasicExample-tvOS' do
        # Uncomment the next line if you're using Swift or would like to use dynamic frameworks
        # use_frameworks!
    
        # Pods for BasicExample-tvOS
    
        target 'BasicExample-tvOSTests' do
          inherit! :search_paths
          # Pods for testing
        end
    
      end

  • pod install

• For android,

  • copy paste the following lines in to settings.gradle

  include ':mailcore2-android-4'
  project(':mailcore2-android-4').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-mailcore/mailcore2-android-4')

  • Add the following code to app/build.gradle of your app.

    • For android tools version com.android.tools.build:gradle:2.2.3

        import com.android.build.gradle.internal.pipeline.TransformTask
      
        def deleteDuplicateJniFiles() {
            def files = fileTree("${buildDir}/intermediates/exploded-aar/com.facebook.react/react-native/0.43.3/jni/") {
                include "**/libgnustl_shared.so"
            }
            files.each { it.delete() }
        }
      
        tasks.withType(TransformTask) { pkgTask ->
            pkgTask.doFirst { deleteDuplicateJniFiles() }
        }

      • Make sure to change the react-native version properly

    • For android tools version com.android.tools.build:gradle:2.3.3

      android {
        ...
        ...
        ...
        ...
        ...
          packagingOptions{
              pickFirst '**/libgnustl_shared.so'
          }
      }

Usage

• Note: For any of the following methods you must first use loginImap
• Note: For SendMail method you must first use loginSmtp
• Note: For the use of attachments download remember to give permission to the application

import MailCore from 'react-native-mailcore';

• Login smtp

  MailCore.loginSmtp({
    hostname: 'smtp.gmail.com',
    port: 465,
    username: '[email protected]',
    password: 'password',
  }).then(result => {
    alert(result.status);
  })
  .catch(error => {
    alert(error);
  });

• Login imap

MailCore.loginImap({
    hostname: 'imap.gmail.com',
    port: 993,
    username: '[email protected]',
    password: 'password',
  }).then(result => {
    alert(result.status);
  })
  .catch(error => {
    alert(error);
  });

• Create Folder

  MailCore.createFolder({
    folder: 'newfoldername'
  }).then(result => {
    alert(result.status);
  })
  .catch(error => {
    alert(error);
  });

• Rename folder

MailCore.renameFolder({
  folderOldName: 'oldFolderName',
  folderNewName: 'newFolderName'
}).then(result => {
  alert(result.status);
})
.catch(error => {
  alert(error);
});

• Delete folder

  MailCore.deleteFolder({
    folder: 'folderName'
  }).then(result => {
    alert(result.status);
  })
  .catch(error => {
    alert(error);
  });

• List folders

MailCore.getFolders()
.then(result => {
  const a = [...result.folders];
  a.forEach(element => {
    alert(element.path);
  });
})
.catch(error => {
    alert(error);
});

• Move Email

  MailCore.moveEmail({
    folderFrom: 'oldfolder',
    messageId: 14,
    folderTo: 'newfolder'
  })
  .then(result => {
    alert(result.status);
  })
  .catch(error => {
      alert(error);
  });

• Permant Email Delete

  MailCore.permantDeleteEmail({
    folderFrom: 'folder',
    messageId: messageId
  })
  .then(result => {
      alert(result.status);
  })
  .catch(error => {
      alert(error);
  });

• Action Flag Message

  MailCore.actionFlagMessage({
    folder: 'folder',
    messageId: messageId,
    flagsRequestKind: <FlagsRequestKind val int>,
    messageFlag: <MessageFlag val int>
  })
  .then(result => {
      alert(result.status);
  })
  .catch(error => {
      alert(error);
  
  });

• Action label Message

  MailCore.actionLabelMessage({
    folder: 'folder',
    messageId: messageId,
    flagsRequestKind: <FlagsRequestKind val int>,
    tags: ["tag1","tag2","tag3"]
  })
  .then(result => {
      alert(result.status);
  })
  .catch(error => {
      alert(error);
  });

• Send Mail

  MailCore.sendMail({
    headers: {
      key: 'value'
    },
    from: {
      addressWithDisplayName: 'from label',
      mailbox: '[email protected]'
    },
    to: {
      "[email protected]": 'to label',
      "[email protected]": 'to label'
    },
    cc: {
      "[email protected]": 'cc label',
      "[email protected]": 'cc label'
    },
    bcc: {
      "[email protected]": 'bcc label',
      "[email protected]": 'bcc label'
    },
    subject: 'subject',
    body: 'body',
    attachments: ["url/filename", "url/filename"]
  })
  .then(result => {
      alert(result.status);
  })
  .catch(error => {
      alert(error);
  });

• Get mail

  MailCore.getMail({
  folder: 'folder',
  messageId: messageId,
  requestKind: <IMAPMessagesRequestKind val int>
  })
  .then(result => {
    let mail = {
      id: result.id,
      date: result.date,
      from: result.from,
      to: result.to,
      cc: result.cc,
      bcc: result.bcc,
      subject: result.subject,
      body: result.body,
      attachments: result.attachments
    }
    alert(result.status);
    console.log(mail)
  })
  .catch(error => {
      alert(error);
  });

• Get Attachment

  MailCore.getAttachment({
    filename: 'filename',
    folder: 'folder',
    messageId: messageId,
    partID: 'partID',
    encoding: encoding,
    folderOutput: 'urlOutput'
  })
  .then(result => {
    alert(result.status);
  })
  .catch(error => {
      alert(error);
  });

• List mails

  MailCore.getMails({
    folder: 'folder',
    requestKind: <IMAPMessagesRequestKind int value>
  })
  .then(result => {
    let promises = [];
    for (let i=0; i<result.mails.length;i++) {
      let mail = result.mails[i];
      let promise = new Promise((resolve,reject) => {
        MailCore.getMail({
          folder: 'folder',
          messageId: mail.id,
          requestKind: <IMAPMessagesRequestKind int value>
          }).then(mailDetails => {
            mail.body = mailDetails.body
            resolve(mail);
          })
          .catch(error => reject(error))
      });
      promises.push(promise)
    }
    Promise.all(promises)
    .then(mails => 
      console.log(mails))
  })
  .catch(error => {
      alert(error);
  });
}

TODO

• [x] createFolder API support
• [x] renameFolder API support
• [x] deleteFolder API support
• [x] listFolders API support
• [x] imapLogin API support
• [x] smtpLogin API support
• [x] GetEmail API support
• [x] MoveEmail API support
• [x] DeleteEmail API support
• [x] Download attachment
• [x] SendEmail with attachments
• [x] addFlags API support
• [x] deleteFlags API support
• [x] GetEmails API support
• [ ] Basic Example