Git Product home page Git Product logo

imap-notify's Introduction

imap-notify

Small library that listens for incoming messages on the imap server and returns the parsed message

Installation

npm install imap-notify

Examples

var 
  notify = require('imap-notify'),
  options,
  notifier;

options = {
  user: '[email protected]',
  password: 'myPassword',
  host: 'imap.host.name',
  port: 993,
  tls: true,
  box: 'Inbox'
};

notifier = notify(options);

notifier.on('error', function(err) {
  console.log(err);
});

notifier.on('mail', function(msg) {
  console.log(msg);
});

notifier.on('success', function() {
  console.log('connection made');
});

notifier.on('close', function() {
  console.log('connection closed');
});

Connection Options

  • user - string - Username for plain-text authentication.
  • password - string - Password for plain-text authentication.
  • xoauth2 - string - Base64-encoded OAuth2 token for The SASL XOAUTH2 Mechanism for servers that support it (See Andris Reinman's xoauth2 module to help generate this string).
  • host - string - Hostname or IP address of the IMAP server. Default: 'localhost
  • port - integer - Port number of the IMAP server. Default: 143
  • tls - boolean - Perform implicit TLS connection? Default: false
  • box - string - The box to listen on for new messages. Default:'Inbox'

Events

  • mail(<Object> message) - Emitted when a new message is received with the new Parsed email message
  • error(<String> error) - Emitted when an error occurs between the library and the imap server
  • close() - Emitted on connection closure
  • success() - Emittied when connection succeeds

Mail Object

  • headers - unprocessed headers in the form of - {key: value} - if there were multiple fields with the same key then the value is an array
  • from - an array of parsed From addresses - [{address:'[email protected]',name:'Sender Name'}] (should be only one though)
  • to - an array of parsed To addresses
  • cc - an array of parsed CC addresses
  • bcc - an array of parsed Bcc addresses
  • subject - the subject line
  • references - an array of reference message id values (not set if no reference values present)
  • inReplyTo - an array of In-Reply-To message id values (not set if no in-reply-to values present)
  • priority - priority of the e-mail, always one of the following: normal (default), high, low
  • text - text body
  • html - html body
  • date - date field as a Date() object. If date could not be resolved or is not found this field is not set. Check the original date string from headers.date
  • attributes - Object containing meta information about message
    • uid - integer - A 32-bit ID that uniquely identifies this message within its mailbox.
    • flags - array - A list of flags currently set on this message.
    • date - Date - The internal server date for the message.
    • struct - array - The message's body structure (only set if requested with fetch()). See below for an explanation of the format of this property.
    • size - integer - The RFC822 message size (only set if requested with fetch()).

imap-notify's People

Contributors

coyle avatar yaroslav-ilin avatar

Stargazers

Marek Kraus avatar Nico Kokonas avatar Josh Dyck avatar  avatar Julian Brown avatar Wes Johnson avatar Li Yi avatar

Watchers

James Cloos avatar

Forkers

gyula-ny

imap-notify's Issues

UNABLE_TO_VERIFY_LEAF_SIGNATURE

I'm receiving this errort when connection to my account:

{ [Error: unable to verify the first certificate] code: 'UNABLE_TO_VERIFY_LEAF_SIGNATURE', source: 'socket' }

I cannot find a solution anywhere!

Problems With Mail Attachments

Hey!
I noticed a bug that occurs sometimes when fetching E-Mails which have one or more attachments. It does not seem to happen everytime and only affects certain file extensions (eg. .zip) as far as I can tell.

Here is the error message I get:

defaultExt = mime.extension(contentType);
^

TypeError: mime.extension is not a function
at MailParser._generateFileName (\node_modules\mailparser\lib\mailparser.js:1407:27)
at MailParser._processStateHeader (
\node_modules\mailparser\lib\mailparser.js:309:61)
at MailParser._process (***\node_modules\mailparser\lib\mailparser.js:227:22)
at runCallback (timers.js:763:18)
at tryOnImmediate (timers.js:734:5)
at processImmediate (timers.js:716:5)

Problem when running

Hey there,
When I try to run my project I get this error.
\node_modules\imap-notify\lib\imap-notify.js:93
.sortByAll()
^

TypeError: _.chain(...).sortByAll is not a function

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.