mailer-advance 6.0.0 → 7.0.0

package/README.md

@@ -1,4 +1,4 @@
-# 🚀 mailer-advance v6.0
+# 🚀 mailer-advance v7.0
 
 [![npm version](https://img.shields.io/npm/v/mailer-advance.svg?style=flat-square)](https://www.npmjs.com/package/mailer-advance)
 [![license](https://img.shields.io/npm/l/mailer-advance.svg?style=flat-square)](https://www.npmjs.com/package/mailer-advance)
@@ -8,10 +8,10 @@
 
 ---
 
-## ✨ v6.0 Highlights
+## ✨ v7.0 Highlights
 
 - ⚡ **Smart Connection**: `connect()` automatically falls back to `process.env.DB_URI`.
-- 📖 **Interactive Swagger UI**: Explore and test all APIs at `/api-docs`.
+- 📖 **Interactive Swagger UI**: Now fully supported in both standalone and **library mode**.
 - 🗄️ **Multi-DB Persistence**: Support for MongoDB, Postgres, and MySQL.
 - 🔄 **Hot-Swapping**: Switch SMTP credentials at runtime via the Dashboard.
 - 🛡️ **Production Ready**: Full STARTTLS support and descriptive error guards.
@@ -33,6 +33,7 @@ import express from 'express';
 import { 
     contactRoutes, 
     configRoutes, 
+    swaggerRoutes, // ✨ New in v7.0
     dbService, 
     DatabaseFactory 
 } from 'mailer-advance';
@@ -45,9 +46,10 @@ const repository = DatabaseFactory.createRepository(process.env.DB_TYPE || 'mong
 await repository.connect(); 
 dbService.setRepository(repository);
 
-// 2. Mount API Routes
+// 2. Mount API Routes & UI
 app.use('/api/mail', contactRoutes);
 app.use('/api/config', configRoutes);
+app.use('/api-docs', swaggerRoutes); // ✨ Mount interactive docs
 
 app.listen(3000, () => {
     console.log('🚀 Engine active at http://localhost:3000');
@@ -59,9 +61,12 @@ app.listen(3000, () => {
 
 ## 📚 Interactive API Documentation (Swagger)
 
-V6.0.0 introduces a fully integrated **Swagger UI** for easier development and testing. Once your server is running, navigate to:
+V7.0.0 enables the **Swagger UI** for library users. Unlike the standalone server where it's pre-mounted, library consumers must explicitly mount it:
 
-👉 **`http://localhost:3000/api-docs`**
+👉 **`app.use('/api-docs', swaggerRoutes);`**
+
+Once mounted, navigate to:
+**`http://localhost:3000/api-docs`**
 
 From there, you can:
 - 🔍 **Explore**: See all available endpoints and their data structures.

package/index.js

@@ -1,5 +1,6 @@
 import contactRoutes from './src/routes/contact.routes.js';
 import configRoutes from './src/routes/config.routes.js';
+import swaggerRoutes from './src/routes/swagger.routes.js';
 import mailService from './src/services/mail.service.js';
 import dbService from './src/services/db.service.js';
 import DatabaseFactory from './src/services/database.factory.js';
@@ -7,6 +8,7 @@ import DatabaseFactory from './src/services/database.factory.js';
 export {
     contactRoutes,
     configRoutes,
+    swaggerRoutes,
     mailService,
     dbService,
     DatabaseFactory
@@ -16,6 +18,7 @@ export {
 export default {
     contactRoutes,
     configRoutes,
+    swaggerRoutes,
     mailService,
     dbService,
     DatabaseFactory

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mailer-advance",
-  "version": "6.0.0",
+  "version": "7.0.0",
   "description": "Advanced Node.js email service with dynamic SMTP configuration, multi-database support (MongoDB/SQL), and a built-in UI.",
   "main": "index.js",
   "type": "module",

package/src/routes/swagger.routes.js

@@ -0,0 +1,10 @@
+import express from 'express';
+import swaggerUi from 'swagger-ui-express';
+import swaggerSpec from '../config/swagger.config.js';
+
+const router = express.Router();
+
+router.use('/', swaggerUi.serve);
+router.get('/', swaggerUi.setup(swaggerSpec));
+
+export default router;