@mailchain/message-composer

Mailchain Message Composer

Warning @mailchain/message-composer library is in development and may not cover all cases yet. Use with caution.

RFC-5322 compliant MIME message composer for Node and for the browser. Just add the content you want and let the library take care of formatting it according to the specification.

Usage

const msg = createMessageComposer(messageComposerContext)
	// .id('[e-mail]') // Optional
	.subject('Subject can contain UTF-8 chars including emojis 😉')
	// .date(new Date('08/28/2022')) // Optional
	.from({ name: 'Bob', address: '[e-mail]' })
	.recipients('To', { name: 'Alice', address: '[e-mail]' })
	.recipients('Cc', { name: 'Joe Doe', address: '[e-mail]' })
	.recipients(
		'Bcc',
		{ name: 'Jane Doe', address: '[e-mail]' },
		{ name: 'Bob', address: '[e-mail]' },
	)
	.message('plain', Buffer.from('Plaintext content. Can also contain UTF-8 and emojis 🤐.'))
	.message('html', Buffer.from('This is ✨rich-text✨ HTML <b>content</b>.'))
	.attachment({
		cid: 'bfcd3a31-646b-4dcd-a1ea-06d37baf7d2e',
		contentType: 'image/png',
		filename: 'mailchain-logo.png',
		content: readFileSync('mailchain-logo.png'),
	});

const { forSender, forVisibleRecipients, forBlindedRecipients } = await msg.build();

For full usage examples view the developer docs.

Installing

Using npm:

$ npm install @mailchain/message-composer

Using yarn:

$ yarn add @mailchain/message-composer