feat: first commit v0.1.0

Author: leandroandrade

.gitattributes

@@ -0,0 +1,2 @@
+# Set default behavior to automatically convert line endings
+* text=auto eol=lf

.github/.stale.yml

@@ -0,0 +1,21 @@
+# Number of days of inactivity before an issue becomes stale
+daysUntilStale: 15
+# Number of days of inactivity before a stale issue is closed
+daysUntilClose: 7
+# Issues with these labels will never be considered stale
+exemptLabels:
+  - "discussion"
+  - "feature request"
+  - "bug"
+  - "help wanted"
+  - "plugin suggestion"
+  - "good first issue"
+# Label to use when marking an issue as stale
+staleLabel: stale
+# Comment to post when marking an issue as stale. Set to `false` to disable
+markComment: >
+  This issue has been automatically marked as stale because it has not had
+  recent activity. It will be closed if no further activity occurs. Thank you
+  for your contributions.
+# Comment to post when closing a stale issue. Set to `false` to disable
+closeComment: false

.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10

.github/tests_checker.yml

@@ -0,0 +1,7 @@
+comment: |
+  Hello! Thank you for contributing!
+  It appears that you have changed the code, but the tests that verify your change are missing. Could you please add them?
+fileExtensions:
+  - '.js'
+
+testDir: 'test'

.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+    branches:
+     - main
+     - master
+     - next
+     - 'v*'
+    paths-ignore:
+      - 'docs/**'
+      - '*.md'
+  pull_request:
+    paths-ignore:
+      - 'docs/**'
+      - '*.md'
+
+jobs:
+  test:
+    uses: fastify/workflows/.github/workflows/plugins-ci.yml@v3
+    with:
+      license-check: true

.github/workflows/package-manager-ci.yml

@@ -0,0 +1,20 @@
+name: package-manager-ci
+
+on:
+  push:
+    branches:
+     - main
+     - master
+     - next
+     - 'v*'
+    paths-ignore:
+      - 'docs/**'
+      - '*.md'
+  pull_request:
+    paths-ignore:
+      - 'docs/**'
+      - '*.md'
+
+jobs:
+  test:
+    uses: fastify/workflows/.github/workflows/plugins-ci-package-manager.yml@v3

.gitignore

@@ -0,0 +1,152 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Clinic
+.clinic
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+.cache
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# Vim swap files
+*.swp
+
+# macOS files
+.DS_Store
+
+# lock files
+package-lock.json
+pnpm-lock.yaml
+yarn.lock
+bun.lockb
+
+# editor files
+.vscode
+.idea
+
+# tap files
+.tap/

.npmrc

@@ -0,0 +1 @@
+package-lock=false

README.md

@@ -1,2 +1,120 @@
-# fastify-mailer
-Fastify nodemailer connection plugin
+# fastify-mailer-provider
+
+This module provides a way to send email using `nodemailer`.
+
+## Install
+```
+npm i fastify-mailer-provider
+```
+
+## Usage
+Add it to you project with `register` and you are done!
+
+```js
+const fastify = require('fastify')()
+
+fastify.register(require('fastify-mailer-provider'), {
+    pool: true,
+    host: 'smtp.example.com',
+    port: 465,
+    secure: true, // use TLS
+    auth: {
+        user: 'username',
+        pass: 'password'
+    }
+})
+
+
+fastify.get('/sendmail/:email', async (req, reply) => {
+    const {email} = req.params
+
+    await fastify.mailer.sendMail({
+        from: 'sender@example.com',
+        to: email,
+        subject: 'foo',
+        text: 'bar'
+    })
+    return reply.status(204).send()
+})
+
+fastify.listen({ port: 3000 }, err => {
+    if (err) throw err
+})
+```
+
+You can also set an email provider for identification:
+```js
+const fastify = require('fastify')()
+
+fastify.register(require('fastify-mailer-provider'), {
+    provider: 'aws', // using aws to send email
+    pool: true,
+    host: 'smtp.example.com',
+    port: 465,
+    secure: true,
+    auth: {
+        user: 'username',
+        pass: 'password'
+    }
+})
+
+
+fastify.get('/sendmail/:email', async (req, reply) => {
+    const {email} = req.params
+
+    await fastify.mailer.aws.sendMail({
+        from: 'sender@example.com',
+        to: email,
+        subject: 'foo',
+        text: 'bar'
+    })
+    return reply.send({
+        provider: fastify.mailer.aws.provider // { provider: 'aws' }
+    })
+})
+
+fastify.listen({ port: 3000 }, err => {
+    if (err) throw err
+})
+```
+
+You can also set multiply an email providers:
+```js
+const fastify = require('fastify')()
+
+fastify.register(require('fastify-mailer-provider'), {
+    provider: 'aws',
+    // ...
+})
+
+fastify.register(require('fastify-mailer-provider'), {
+    provider: 'google',
+    // ...
+})
+
+fastify.register(require('fastify-mailer-provider'), {
+    provider: 'sendgrid',
+    // ...
+})
+
+fastify.get('/sendmail/:email', async (req, reply) => {
+    const {email} = req.params
+
+    await fastify.mailer.aws.sendMail({ /*...*/ })
+    await fastify.mailer.google.sendMail({ /*...*/ })
+    await fastify.mailer.sendgrid.sendMail({ /*...*/ })
+    // ...
+})
+
+fastify.listen({ port: 3000 }, err => {
+    if (err) throw err
+})
+```
+
+## Documentation
+
+More details about nodemailer documentation, see [nodemailer docs](https://nodemailer.com/about/).
+
+## License
+
+[MIT License](https://github.com/leandroandrade/fastify-mailer-provider/blob/main/LICENSE/)

example.js

@@ -0,0 +1,29 @@
+const fastify = require('fastify')()
+
+fastify.register(require('./'), {
+  provider: 'sendgrid',
+  pool: true,
+  host: 'smtp.example.com',
+  port: 465,
+  secure: true,
+  auth: {
+    user: 'user',
+    pass: 'pass'
+  }
+})
+
+fastify.get('/sendmail/:email', async (req, reply) => {
+  const { email } = req.params
+
+  await fastify.mailer.sendgrid.sendMail({
+    from: 'sender@example.com',
+    to: email,
+    subject: 'foo',
+    text: 'bar'
+  })
+  return reply.status(204).send()
+})
+
+fastify.listen({ port: 3000 }, err => {
+  if (err) throw err
+})