[{"_1":2,"_178":-5,"_179":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_154":155},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_95":-5,"_96":97,"_143":-5,"_144":11,"_145":21,"_146":11,"_147":-5,"_148":11,"_149":-5,"_150":151,"_152":98,"_153":-7},"canonicalUrl","https://hub.docker.com/r/souravbapari/emailing/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","souravbapari","reponame","emailing","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_50":51,"_53":54,"_55":56,"_57":11,"_58":59,"_60":61,"_62":63,"_43":35,"_32":33,"_65":66,"_67":-5,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":69,"_76":77,"_78":11,"_79":33,"_80":81,"_86":11,"_87":88,"_92":33,"_93":94},"categories",[42,47],{"_43":44,"_45":46},"name","Message queues","slug","message-queues",{"_43":48,"_45":49},"Developer tools","developer-tools","content_types",[52],"image","date_registered","2025-12-22T08:29:05.069692Z","description","High-performance email delivery and scheduling service using Bun, BullMQ, and Redis.","is_private","last_updated","2025-12-23T21:31:00.124672Z","last_modified","2025-12-23T11:50:27.663317Z","media_types",[64],"application/vnd.oci.image.index.v1+json","pull_count",893,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

Mailing Service

\n\nA production-ready **email delivery and scheduling service** built with **Bun** , **BullMQ** , and **Redis** , designed to run seamlessly with Docker and Docker Compose.\n\n---\n\n## Features\n\n- SMTP email sending\n- Scheduled email delivery\n- Redis-backed job queue (BullMQ)\n- High-performance Bun runtime\n- Docker-first deployment\n- Graceful shutdown & retry support\n\n---\n\n## Architecture\n\n```\n┌──────────────────┐ ┌──────────────┐\n│ Mailing Service │ 6379 │ Redis 7 │\n│ (Bun + BullMQ) │──────▶│ Job Queue │\n└──────────────────┘ └──────────────┘\n```\n\nEach service runs in its own container following Docker best practices.\n\n---\n\n## Requirements\n\n- Docker 20+\n- Docker Compose v2+\n\n---\n\n## Quick Start\n\n### 1. Clone the repository\n\n```bash\ngit clone \ncd mailing-service\n```\n\n---\n\n### 2. Start services\n\n```bash\ndocker compose up --build -d\n```\n\nServices started:\n\n- Mailing Service → `http://localhost:5878`\n- Redis → internal container network\n\n---\n\n### 3. Stop services\n\n```bash\ndocker compose down\n```\n\n---\n\n## docker-compose.yml\n\n```yaml\nversion: \"3.9\"\n\nservices:\n app:\n build: .\n container_name: mailing-service\n ports:\n - \"5878:5878\"\n environment:\n PORT: 5878\n REDIS_HOST: redis\n REDIS_PORT: 6379\n API_KEY: hello\n depends_on:\n - redis\n restart: unless-stopped\n\n redis:\n image: redis:7\n container_name: redis\n restart: unless-stopped\n volumes:\n - redis-data:/data\n\nvolumes:\n redis-data:\n```\n\n---\n\n## Environment Variables\n\n| Variable | Description | Required |\n| ---------------- | ---------------------- | -------- |\n| `PORT` | Application port | ✅ |\n| `REDIS_HOST` | Redis hostname | ✅ |\n| `REDIS_PORT` | Redis port | ✅ |\n| `API_KEY` | API authentication key | ✅ |\n| `REDIS_USERNAME` | Redis ACL username | ❌ |\n| `REDIS_PASSWORD` | Redis password | ❌ |\n\n---\n\n## API Authentication\n\nAll requests must include the API key:\n\n### Header\n\n```\nAuthorization: Bearer token\n```\n\n---\n\n## Using the Node.js Client\n\nThe easiest way to interact with the Mailing Service is using the official Node.js client package.\n\n### Installation\n\n```bash\nnpm install emailing-service\n```\n\nor\n\n```bash\npnpm add emailing-service\n```\n\nor\n\n```bash\nbun add emailing-service\n```\n\n### Quick Start\n\n```ts\nimport { Mailing } from \"emailing-service\";\n\nconst mailer = new Mailing({\n host: \"http://localhost:5878\", // Your mailing service URL\n apiKey: \"your-api-key\",\n credential: {\n host: \"smtp.gmail.com\",\n port: 587,\n secure: false,\n auth: {\n user: \"no-reply@gmail.com\",\n pass: \"app-password\",\n },\n },\n});\n\n// Send email immediately\nawait mailer.send({\n from: \"no-reply@gmail.com\",\n to: \"user@example.com\",\n subject: \"Welcome\",\n text: \"Hello from Mailing Service\",\n});\n\n// Schedule email for later\nconst scheduled = await mailer.schedule(\n new Date(Date.now() + 60 * 60 * 1000) // 1 hour later\n);\n\nconst result = await scheduled.send({\n from: \"no-reply@gmail.com\",\n to: \"user@example.com\",\n subject: \"Scheduled Email\",\n html: \"

Hello

This email was scheduled.

\",\n});\n\n// Check email existence\nconst check = await mailer.isEmailExistence(\"user@example.com\");\nconsole.log(check.data.exists); // true or false\n\n// Cancel scheduled email\nawait mailer.cancelMail(result.data.id);\n```\n\nFor more details, visit the [npm package page](https://www.npmjs.com/package/emailing-service).\n\n---\n\n## Example API Request\n\n### Send Email\n\n```http\nPOST /mail/send\nContent-Type: application/json\nAuthorization: Bearer token\n```\n\n```json\n{\n \"credential\": {\n \"host\": \"smtp.gmail.com\",\n \"port\": 587,\n \"secure\": false,\n \"auth\": {\n \"user\": \"no-reply@gmail.com\",\n \"pass\": \"app-password\"\n }\n },\n \"email\": {\n \"from\": \"no-reply@gmail.com\",\n \"to\": \"user@example.com\",\n \"subject\": \"Test Email\",\n \"text\": \"Hello from Mailing Service\"\n }\n}\n```\n\n---\n\n### Schedule Email\n\n```http\nPOST /mail/schedule?date=2025-01-30T10:00:00Z\nContent-Type: application/json\nAuthorization: Bearer token\n```\n\n```json\n{\n \"credential\": {\n \"host\": \"smtp.gmail.com\",\n \"port\": 587,\n \"secure\": false,\n \"auth\": {\n \"user\": \"no-reply@gmail.com\",\n \"pass\": \"app-password\"\n }\n },\n \"email\": {\n \"from\": \"no-reply@gmail.com\",\n \"to\": \"user@example.com\",\n \"subject\": \"Scheduled Email\",\n \"html\": \"

Hello

This email was scheduled.

\"\n }\n}\n```\n\n### Check Email Existence\n\n```http\nGET /mail/existence?email=user@example.com\nAuthorization: Bearer token\n```\n\n**Response:**\n\n```json\n{\n \"status\": true,\n \"email\": \"user@example.com\",\n \"exists\": true,\n \"date\": \"2025-01-30T10:00:00.000Z\"\n}\n```\n\n---\n\n### Cancel Scheduled Job\n\n```http\nPOST /mail/cancel/:jobId\nAuthorization: Bearer token\n```\n\n**Example:**\n\n```http\nPOST /mail/cancel/job-id-456\nAuthorization: Bearer token\n```\n\n**Response:**\n\n```json\n{\n \"status\": true,\n \"jobId\": \"job-id-456\",\n \"result\": true,\n \"date\": \"2025-01-30T10:00:00.000Z\"\n}\n```\n\n---\n\n## Redis Persistence\n\nRedis data is persisted using Docker volumes:\n\n```\nredis-data\n```\n\nThis ensures queued jobs survive container restarts.\n\n---\n\n## Health & Stability\n\n- Automatic container restart (`unless-stopped`)\n- Redis ≥ 7 (BullMQ recommended)\n- Graceful shutdown using exec-form CMD\n- No manual Redis connection handling\n\n---\n\n## Security Best Practices\n\n- Do **not** commit `.env` files\n- Use secrets management in production\n- Restrict Redis access to internal networks\n- Rotate SMTP credentials regularly\n\n---\n\n## Production Notes\n\n- Use immutable image tags (`v1.0.0`)\n- Add Redis authentication for public deployments\n- Scale workers horizontally if needed\n- Use a managed Redis service for high availability\n\n---\n\n## License\n\nMIT License\n\n---\n\n## Support & Contributions\n\nIssues and pull requests are welcome.\nFor production hardening or enterprise setups, please open a discussion.\n","has_starred","hub_user","immutable_tags_settings",{"_82":11,"_83":84},"enabled","rules",[85],".*","is_automated","permissions",{"_89":21,"_90":11,"_91":11},"read","write","admin","user","storage_size",110765093,"orgData","recentTags",[98],{"_99":52,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_58":132,"_133":101,"_134":33,"_135":64,"_43":136,"_137":138,"_139":129,"_140":132,"_141":73,"_142":21},"content_type","creator",38740557,"digest","sha256:6d930cbfa8270e7e8bb372b1074bf14bc30f757dc4a4d5dba857a12e9fbf963b","full_size",101897602,"id",1035881367,"images",[110,126],{"_111":112,"_102":113,"_114":115,"_116":117,"_118":119,"_120":121,"_122":115,"_123":-5,"_124":105,"_70":73,"_125":-5},"architecture","amd64","sha256:45b02d169679712681752f7299f93fed4e06c51f682c8d7de8b55609fe3f9477","features","","last_pulled","2026-10-03T14:14:22.541970845Z","last_pushed","2025-12-23T11:01:59.503846288Z","os","linux","os_features","os_version","size","variant",{"_111":127,"_102":128,"_114":115,"_116":129,"_118":130,"_120":127,"_122":115,"_123":-5,"_124":131,"_70":73,"_125":-5},"unknown","sha256:e568ec8fcbdead0ee122ca6df8e14c60187a96d9b14939a5dbacbad4ab258b13","2026-10-03T14:14:22.550975791Z","2025-12-23T11:01:59.577954727Z",1180,"2025-12-23T11:02:00.935933Z","last_updater","last_updater_username","media_type","latest","repository",29536724,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":156,"_165":166,"_150":176,"_177":11},{"_40":157,"_50":160,"_53":54,"_55":56,"_57":11,"_58":59,"_60":61,"_62":161,"_43":35,"_32":33,"_65":66,"_67":-5,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":69,"_76":77,"_78":11,"_79":33,"_80":162,"_86":11,"_87":164,"_92":33,"_93":94},[158,159],{"_43":44,"_45":46},{"_43":48,"_45":49},[52],[64],{"_82":11,"_83":163},[85],{"_89":21,"_90":11,"_91":11},"tags",{"_167":71,"_168":-5,"_169":-5,"_170":171},"count","next","previous","results",[172],{"_99":52,"_100":101,"_102":103,"_104":105,"_106":107,"_108":173,"_58":132,"_133":101,"_134":33,"_135":64,"_43":136,"_137":138,"_139":129,"_140":132,"_141":73,"_142":21},[174,175],{"_111":112,"_102":113,"_114":115,"_116":117,"_118":119,"_120":121,"_122":115,"_123":-5,"_124":105,"_70":73,"_125":-5},{"_111":127,"_102":128,"_114":115,"_116":129,"_118":130,"_120":127,"_122":115,"_123":-5,"_124":131,"_70":73,"_125":-5},[],"canDeleteTags","actionData","errors"]

souravbapari/emailing

Tags for souravbapari/emailing