feat: add email providers (#2)

* feat: add comprehensive tests for email providers (http, mailcrab, resend) and utility functions

- Implemented tests for the http provider including initialization, email sending, and error handling.
- Added tests for the mailcrab provider covering connection, email sending, and credential validation.
- Developed tests for the resend provider focusing on API availability, email sending, and error scenarios.
- Created utility function tests for error creation, message ID generation, request handling, and retry logic.
- Configured TypeScript settings and Vitest for improved testing experience and coverage reporting.

* feat: add MailCrab setup to CI workflow and configure Renovate for dependency management

* fix: update coverage reporter configuration in vitest setup

* feat: add onlyBuiltDependencies configuration for esbuild in pnpm workspace

* feat: add badges for npm version, downloads, bundle size, JSDocs, and license in README

Author: productdevbook

.env.example

@@ -0,0 +1,8 @@
+AWS_REGION=
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+FROM_EMAIL=
+TO_EMAIL=
+RESEND_FROM_EMAIL=bounced@resend.dev
+RESEND_TO_EMAIL=delivered@resend.dev
+RESEND_API_KEY=

.github/workflows/autofix.yml

@@ -0,0 +1,29 @@
+name: autofix.ci
+on:
+  pull_request:
+  push:
+    branches: [main]
+    paths:
+      - '!scripts/**'
+
+permissions:
+  contents: read
+
+jobs:
+  autofix:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - run: corepack enable
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          cache: pnpm
+      - run: pnpm install
+
+      - name: Fix lint issues
+        run: npm run lint:fix
+      - uses: autofix-ci/action
+        with:
+          commit-message: 'fix: lint issues'

.github/workflows/ci.yml

@@ -0,0 +1,73 @@
+name: CI
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+  pull-requests: write
+
+on:
+  push:
+    branches:
+      - main
+    paths-ignore:
+      - 'docs/**'
+
+  pull_request:
+    branches:
+      - main
+    paths-ignore:
+      - 'docs/**'
+
+jobs:
+  build-test:
+    runs-on: ${{ matrix.os }}
+
+    permissions:
+      # Required to checkout the code
+      contents: read
+      # Required to put a comment into the pull-request
+      pull-requests: write
+
+    strategy:
+      matrix:
+        os: [ubuntu-latest]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - run: corepack enable
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          cache: pnpm
+
+      - name: 📦 Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: 👀 Lint
+        run: pnpm lint
+
+      - name: 👀 Typecheck
+        run: pnpm type-check
+
+      - name: 🚀 Build
+        run: pnpm build
+
+      - name: 🐳 Setup MailCrab
+        run: |
+          docker pull marlonb/mailcrab
+          docker run -d --name unemail-mailcrab -p 1025:1025 -p 1080:1080 marlonb/mailcrab
+
+      - name: 🧪 Test with coverage
+        run: pnpm test:coverage
+        env:
+          MAILCRAB_HOST: localhost
+          MAILCRAB_SMTP_PORT: 1025
+          MAILCRAB_UI_PORT: 1080
+
+      - name: 📝 Upload coverage
+        if: always()
+        uses: davelosert/vitest-coverage-report-action@v2

.github/workflows/release.yml

@@ -0,0 +1,25 @@
+name: Release
+
+permissions:
+  contents: write
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+
+      - run: npx changelogithub
+        env:
+          GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}

.gitignore

@@ -0,0 +1,15 @@
+.vscode
+node_modules
+*.log
+.DS_Store
+coverage
+dist
+tmp
+/drivers
+/test.*
+__*
+.vercel
+.netlify
+test/fs-storage/**
+.env
+.wrangler