mail-listener4

    1.1.3 • Public • Published

    Overview

    Mail-listener4 library for node.js. Get notification when new email arrived to inbox or when message metadata (e.g. flags) changes externally. Uses IMAP protocol.

    This package has few improvements and fixes over the mail-listener2.

    • Fixing mime.extension is not function error
    • adding a field which gives the total number of mails.

    We are using these libraries: node-imap, mailparser.

    Heavily inspired by mail-listener2.

    Use

    Install

    npm install mail-listener4

    JavaScript Code:

     
    var MailListener = require("mail-listener4");
     
    var mailListener = new MailListener({
      username: "imap-username",
      password: "imap-password",
      host: "imap-host",
      port: 993, // imap port
      tls: true,
      connTimeout: 10000, // Default by node-imap
      authTimeout: 5000, // Default by node-imap,
      debug: console.log, // Or your custom function with only one incoming argument. Default: null
      tlsOptions: { rejectUnauthorized: false },
      mailbox: "INBOX", // mailbox to monitor
      searchFilter: ["ALL"], // the search filter being used after an IDLE notification has been retrieved
      markSeen: true, // all fetched email willbe marked as seen and not fetched next time
      fetchUnreadOnStart: true, // use it only if you want to get all unread email on lib start. Default is `false`,
      mailParserOptions: {streamAttachments: true}, // options to be passed to mailParser lib.
      attachments: true, // download attachments as they are encountered to the project directory
      attachmentOptions: { directory: "attachments/" } // specify a download directory for attachments
    });
     
    mailListener.start(); // start listening
     
    // stop listening
    //mailListener.stop();
     
    mailListener.on("server:connected", function(){
      console.log("imapConnected");
    });
     
    mailListener.on("mailbox", function(mailbox){
      console.log("Total number of mails: ", mailbox.messages.total); // this field in mailbox gives the total number of emails
    });
     
    mailListener.on("server:disconnected", function(){
      console.log("imapDisconnected");
    });
     
    mailListener.on("error", function(err){
      console.log(err);
    });
     
    mailListener.on("mail", function(mail, seqno, attributes){
      // do something with mail object including attachments
      console.log("emailParsed", mail);
      // mail processing code goes here
    });
     
    mailListener.on("attachment", function(attachment){
      console.log(attachment.path);
    });
     
    // it's possible to access imap object from node-imap library for performing additional actions. E.x.
    mailListener.imap.move(:msguids, :mailboxes, function(){})
     

    That's easy!

    Attachments

    Attachments can be streamed or buffered. This feature is based on how mailparser handles attachments. Setting attachments: true will download attachments as buffer objects by default to the project directory. A specific download directory may be specified by setting attachmentOptions: { directory: "attachments/"}. Attachments may also be streamed using attachmentOptions: { stream: "true"}. The "attachment" event will be fired every time an attachment is encountered. Refer to the mailparser docs for specifics on how to stream attachments.

    License

    MIT

    Install

    npm i mail-listener4

    DownloadsWeekly Downloads

    856

    Version

    1.1.3

    License

    MIT

    Unpacked Size

    11.4 kB

    Total Files

    6

    Last publish

    Collaborators

    • avatar