directmail
v0.1.8
Published
Sendmail replacement, sends mail directly to recipients SMTP server
Downloads
17,098
Readme
DirectMail
Sendmail alternative to send e-mails directly to recipients without a relaying service.
Support DirectMail development
If you want to support with Bitcoins then my wallet address is 15Z8ADxhssKUiwP3jbbqJwA21744KMCfTM
Usage
Setup
Require directmail object
var createDirectmail = require("directmail"),
directmail = createDirectmail(options);
Where
- options is an optional options object with the following properties
- debug - if set to true, prints all traffic to console
- name - hostname to be used when introducing the client to the MX server
Send mail
Push a message to the outgoing queue
directmail.send({
from: "[email protected]",
recipients: ["[email protected]", "[email protected]"],
message: "Subject: test\r\n\r\nHello world!"
});
Where
- from (string) is the e-mail address of the sender
- recipients (array) is an array of recipient e-mails. Put all
to
,cc
andbcc
addresses here. - message (string|buffer) is the RFC2822 message to be sent
Check queue length
You can check the count of unsent messages from the .length
property of the directmail object
console.log(directmail.length); // nr of messages to be sent
If you try to send a message with multiple recipients then every unique recipient domain counts as a different message.
Issues
Directmail is very inefficient as it queues all e-mails to be sent into memory. Additionally, if a message is not yet sent and the process is closed, all data about queued messages are lost. Thus directmail is only suitable for low throughput systems, like password remainders and such, where the message can be processed immediatelly. Directmail is not suitable for spamming.
While not being 100% reliable (remember - if process exits, entire queue is lost), directmail can still handle sending errors, graylisting and such. If a message can not be sent, it is requeued and retried later.
License
MIT