esf-eml-rcv

ESF E-mail Receiver

Promised-based wrapper over imap, configured via esfcfg.json or in-memory config Object.

Example

const  
  App   =require('../index.js').EmlRcv,
  cfgObj={
    schemaVersion:'0.5.0',
    pcs:          {
      totalTimeout: 7200000,
      portion:      100000
    },
    imap:         {
      user:    '{USER_LOGIN}',
      password:'{USER_PASSWORD}',
      host:    '{IMAP_HOST}',
      port:    IMAP_PORT,
      tls:     true
    },
    rules:        {
      flag:'UNSEEN',
      from:                {
        addr:       'all',
        regex:      '',
        list:       []
      },
      dateRange:           {
        since:'2015-06-30 00:00:00',
        till: '2017-07-01 23:59:59'
      },
      attachmentTypes:     [
        'application'
      ],
      attachmentSubtypes:  [
        'x-excel'
      ],
      attachmentExtensions:[
        'xls'
      ]
    },
    local:        {
      clearPaths:false,
      path:      'tst/d/eml/rcv/',
      subDirs:   {
        raw:'raw/',
        att:'att/',
        unm:'unm/'
      }
    }
  }
  ;
 
app
  .run(cfgObj)
  .then(r=>{
    done();
  })
  .catch(e=>{
    done(e);
  })
;
 

Road map

Version	Functionality	Status	Implemented Methods
0.1.0	Check mail and save attachments (req: esf-eml-rcv-1.1, esf-eml-rcv-1.2	released	receiveMail
0.2.0	Fetch by portions (req. esf-eml-rcv-1.3)		checkMail
1.0.0	API v.1.0 esf-eml-rcv-1.0		reloadConfig
1.1.0	API v.1.1 esf-eml-rcv-1.0		reloadConfig

Requirements

esf-eml-rcv-1

ReqId	Requirement
esf-eml-rcv-0.1	It should have configurable time intervals for mails
esf-eml-rcv-0.2	It should save attachments from mails, according set of mime-types
esf-eml-rcv-0.3	It should save other attachments according extension into separate folder
esf-eml-rcv-0.4	It should fetch mail by portions, sized in config
esf-eml-rcv-1.0	It should implement API 1.0
esf-eml-rcv-1.1	It should have an option to copy saved files to persistent place
esf-eml-rcv-1.2	It should run the complete activity flow with a single method

API

v.1.1

class EmlRcv extends Bsc {
  Promise run([string pathToConfigFile|object configObject])          // runs complete activity flow
  Promise reloadConfig([string pathToConfigFile|object configObject]) //inherited
  Promise getCurrentDateTime()
  Promise createFolders(string folderName)
  Promise processMessage(integer msgId, Buffer buffer, string opDir)
  Promise initMailBox()
  Promise checkMail(imap)
  Promise receiveMail(operationDir,searchResultPortion,imap)
  Promise splitMessagesRangeAndFetch(operationDir,searchResult,imap)
}

API v.1.0

class EmlRcv extends Bsc {
  Promise reloadConfig([string pathToConfigFile]) //inherited
  Promise checkMail()
  Promise receiveMail(string operationDir)
}

---

© MIT bondden 2009-2016