gmailer_by_semicile
v1.2.0
Published
A custom Node.js library for sending emails via Gmail.
Downloads
1
Readme
Here is the updated README.md
file with the corrected usage example:
Gmailer
A Node.js library for sending emails via Gmail. Supports sending single emails, multiple emails, and emails from Excel sheets.
Installation
You can install the library via npm. Make sure you have Node.js installed.
npm install gmailer_by_semicile
Features
- Gmail Setup: Easily set up Gmail authentication for sending emails.
- Send Single Email: Send a single email to one recipient.
- Send Multiple Emails: Send emails to multiple recipients at once.
- Send Emails from Excel: Send personalized emails to recipients listed in an Excel file.
Usage
const emailLibrary = require('gmailer_by_semicile');
(async () => {
try {
// Send a single email
const singleMailResult = await emailLibrary.sendSingleMail('[email protected]', 'your-app-password', '[email protected]', 'Test Subject', 'Test Body');
console.log('Single Mail Result:', singleMailResult);
// Send multiple emails
const recipients = ['[email protected]', '[email protected]'];
const multipleMailsResult = await emailLibrary.sendMultipleMails('[email protected]', 'your-app-password', recipients, 'Test Subject', 'Test Body');
console.log('Multiple Mails Result:', multipleMailsResult);
// Send emails from an Excel file
const filePath = 'path/to/your/excel/file.xlsx';
const excelMailsResult = await emailLibrary.sendExcelMails(filePath, '[email protected]', 'your-app-password', 'Test Subject', 'Test Body');
console.log('Excel Mails Result:', excelMailsResult);
} catch (error) {
console.error('Error:', error);
}
})();
API
gmailSetup(userEmail, appPassword)
Set up Gmail authentication with your email and app password.
userEmail
(string): Your Gmail email address.appPassword
(string): Your Gmail app password.
sendSingleMail(userEmail, appPassword, to, subject, text)
Send a single email using Gmail.
userEmail
(string): Your Gmail email address.appPassword
(string): Your Gmail app password.to
(string): Recipient's email address.subject
(string): Email subject.text
(string): Email body text.
sendMultipleMails(userEmail, appPassword, recipients, subject, text)
Send multiple emails using Gmail.
userEmail
(string): Your Gmail email address.appPassword
(string): Your Gmail app password.recipients
(array of strings): Array of recipient email addresses.subject
(string): Email subject.text
(string): Email body text.
sendExcelMails(filePath, userEmail, appPassword, subject, text)
Send emails to recipients listed in an Excel file using Gmail.
filePath
(string): Path to the Excel file containing recipient email addresses.userEmail
(string): Your Gmail email address.appPassword
(string): Your Gmail app password.subject
(string): Email subject.text
(string): Email body text.
License
This project is licensed under the ISC License. See the LICENSE file for details.
Contributing
Contributions are welcome! Please fork the repository and submit a pull request.
Issues
Report any issues or feature requests on the GitHub Issues page.
Author
- Your Name
- GitHub: github.com/Semicile17
### Adjustments Made:
- The usage example now correctly utilizes `async`/`await` for asynchronous function calls.
- Provided a detailed example of using the library functions within an `async` IIFE.
- Ensured the `try...catch` block is included to handle potential errors.
Once you have this `README.md` in your repository, it will serve as a comprehensive guide for users of your library.