[{"_1":2,"_170":-5,"_171":-5},"loaderData",{"_3":4,"_13":14,"_20":21,"_146":147},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":11,"_17":11,"_18":19},"username","isBillingDecouplingSeatCount","isSearchBoxExperimentEnabled","isAskGordonEnabled",true,"routes/_layout.r.$namespace.$reponame",{"_22":23,"_24":-5,"_25":11,"_26":11,"_27":28,"_29":30,"_31":-5,"_32":11,"_33":34,"_90":-5,"_91":92,"_139":-5,"_140":11,"_141":11,"_142":11,"_143":-5,"_144":145},"canonicalUrl","https://hub.docker.com/r/souravbapari/emailing/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","souravbapari","reponame","emailing","cloudBuildSource","isAutobuildsAvailable","repo",{"_35":36,"_45":46,"_48":49,"_50":51,"_52":11,"_53":54,"_55":56,"_57":58,"_38":30,"_27":28,"_60":61,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":-5,"_70":64,"_71":72,"_73":11,"_74":28,"_75":76,"_81":11,"_82":83,"_87":28,"_88":89},"categories",[37,42],{"_38":39,"_40":41},"name","Message queues","slug","message-queues",{"_38":43,"_40":44},"Developer tools","developer-tools","content_types",[47],"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",[59],"application/vnd.oci.image.index.v1+json","pull_count",752,"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",{"_77":11,"_78":79},"enabled","rules",[80],".*","is_automated","permissions",{"_84":19,"_85":11,"_86":11},"read","write","admin","user","storage_size",110765093,"orgData","recentTags",[93],{"_94":47,"_95":96,"_97":98,"_99":100,"_101":102,"_103":104,"_53":127,"_128":96,"_129":28,"_130":59,"_38":131,"_132":133,"_134":135,"_136":127,"_137":68,"_138":19},"content_type","creator",38740557,"digest","sha256:6d930cbfa8270e7e8bb372b1074bf14bc30f757dc4a4d5dba857a12e9fbf963b","full_size",101897602,"id",1035881367,"images",[105,121],{"_106":107,"_97":108,"_109":110,"_111":112,"_113":114,"_115":116,"_117":110,"_118":-5,"_119":100,"_65":68,"_120":-5},"architecture","amd64","sha256:45b02d169679712681752f7299f93fed4e06c51f682c8d7de8b55609fe3f9477","features","","last_pulled","2026-07-14T23:04:54.43534205Z","last_pushed","2025-12-23T11:01:59.503846288Z","os","linux","os_features","os_version","size","variant",{"_106":122,"_97":123,"_109":110,"_111":124,"_113":125,"_115":122,"_117":110,"_118":-5,"_119":126,"_65":68,"_120":-5},"unknown","sha256:e568ec8fcbdead0ee122ca6df8e14c60187a96d9b14939a5dbacbad4ab258b13","2026-07-14T23:04:54.429837177Z","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","2026-07-15T00:46:43.147902255Z","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_33":148,"_157":158,"_144":168,"_169":11},{"_35":149,"_45":152,"_48":49,"_50":51,"_52":11,"_53":54,"_55":56,"_57":153,"_38":30,"_27":28,"_60":61,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":-5,"_70":64,"_71":72,"_73":11,"_74":28,"_75":154,"_81":11,"_82":156,"_87":28,"_88":89},[150,151],{"_38":39,"_40":41},{"_38":43,"_40":44},[47],[59],{"_77":11,"_78":155},[80],{"_84":19,"_85":11,"_86":11},"tags",{"_159":66,"_160":-5,"_161":-5,"_162":163},"count","next","previous","results",[164],{"_94":47,"_95":96,"_97":98,"_99":100,"_101":102,"_103":165,"_53":127,"_128":96,"_129":28,"_130":59,"_38":131,"_132":133,"_134":135,"_136":127,"_137":68,"_138":19},[166,167],{"_106":107,"_97":108,"_109":110,"_111":112,"_113":114,"_115":116,"_117":110,"_118":-5,"_119":100,"_65":68,"_120":-5},{"_106":122,"_97":123,"_109":110,"_111":124,"_113":125,"_115":122,"_117":110,"_118":-5,"_119":126,"_65":68,"_120":-5},[],"canDeleteTags","actionData","errors"]

souravbapari/emailing

Tags for souravbapari/emailing