3.0.3 • Published 5 years ago

@coolgk/email v3.0.3

Weekly downloads
72
License
MIT
Repository
github
Last release
5 years ago

@coolgk/email

a javascript / typescript module

npm install @coolgk/email

a email sender wrapper class

Report bugs here: https://github.com/coolgk/node-utils/issues

Examples

import { Email } from '@coolgk/email';
// OR
// const { Email } = require('@coolgk/email');

const email = new Email({host: 'localhost'});

email.send({
    subject: 'hello this is email subject',
    from: {
            name: 'Daniel Gong',
            email: 'daniel.k.gong@example.com'
    },
    to: [
        {
            name: 'Dan Go',
            email: 'dan@example.com'
        },
        'gong@example.com'
    ],
    message: '<html><body><h1>test</h1>some message here <img src="cid:my-image" width="500" height="250"></body></html>',
    attachments: [
        {
            path: '/tmp/test.png',
            name: 'screenshot.png'
        },
        {
            path:"/tmp/test.png",
            headers:{"Content-ID": "<my-image>"}
        }
    ]
}).then((sentMessage) => {
    console.log(sentMessage);
}).catch((error) => {
    console.log(error);
});

Email

Kind: global class
See: https://www.npmjs.com/package/emailjs#emailserverconnectoptions

new Email(options)

ParamTypeDefaultDescription
optionsobject
options.userstringusername for logging into smtp
options.passwordstringpassword for logging into smtp
options.hoststring"'localhost'"smtp host
options.portstringsmtp port (if null a standard port number will be used)
options.sslbooleanboolean (if true or object, ssl connection will be made)
options.tlsbooleanboolean (if true or object, starttls will be initiated)
options.domainstringdomain to greet smtp with (defaults to os.hostname)
options.authenticationArray.<string>authentication methods

email.send(options, attachments) ⇒ promise

Kind: instance method of Email
Returns: promise - - message sent

ParamTypeDescription
optionsobject
options.subjectstringemail subject
options.messagestringhtml email message
options.toArray.<(string|object)>to email address
options.to[].namestringname of the recipient
options.to[].emailstringemail address of the recipient
options.fromstring | objectsee options.to
options.ccArray.<(string|object)>see options.to
options.bccArray.<(string|object)>see options.to
attachmentsArray.<object>email attachments
attachments.pathstringfile path
attachments.namestringfile name
attachments.typestringfile mime type
attachments.methodstringmethod to send attachment as (used by calendar invites)
attachments.headersobjectattachment headers, header: value pairs, e.g. {"Content-ID":""}
3.0.3

5 years ago

3.0.2

6 years ago

3.0.1

6 years ago

3.0.0

6 years ago

2.0.7

6 years ago

2.0.6

6 years ago

2.0.5

6 years ago

2.0.4

6 years ago

2.0.3

6 years ago

2.0.2

6 years ago

2.0.1

6 years ago

2.0.0

6 years ago

1.1.4

6 years ago

1.1.3

6 years ago

1.1.2

6 years ago

1.1.1

6 years ago

1.1.0

6 years ago

1.0.9

6 years ago

1.0.8

6 years ago

1.0.6

6 years ago

1.0.5

6 years ago

1.0.4

6 years ago

1.0.3

6 years ago