news-cms-module 0.0.1

package/config/index.js

@@ -0,0 +1,34 @@
+const path = require('path');
+
+// Konfigurasi Default untuk Package Anda
+const defaultConfig = {
+    // Pengaturan Router
+    adminRoutePrefix: '/admin',       // Prefix default untuk route CRUD admin
+    publicRoutePrefix: '/',           // Prefix default untuk route publik
+
+    // Pengaturan Views
+    viewEngine: 'ejs',                // Template engine default
+    baseLayout: 'layout',             // Nama file layout utama (jika digunakan)
+
+    // Pengaturan Assets (CSS/JS)
+    assetsUrlPrefix: '/nc-assets',    // Prefix default untuk URL aset statis
+    assetsPath: path.join(__dirname, '..', 'assets'), // Path fisik default ke folder assets
+
+    // Pengaturan Pelacakan (Tracking)
+    trendingTimeframeHours: 24,       // Jendela waktu default untuk menghitung trending (24 jam)
+    maxTrendingPosts: 10,             // Jumlah maksimum berita trending yang dikembalikan
+};
+
+/**
+ * Menggabungkan konfigurasi default package dengan konfigurasi kustom dari pengguna.
+ * @param {object} userConfig - Konfigurasi yang disediakan oleh aplikasi yang menginstal package.
+ * @returns {object} Objek konfigurasi akhir yang lengkap.
+ */
+module.exports = (userConfig = {}) => {
+    // Menggunakan penyebaran (spread operator) untuk menggabungkan objek.
+    // userConfig akan menimpa (overwrite) defaultConfig jika ada properti yang sama.
+    return {
+        ...defaultConfig,
+        ...userConfig
+    };
+};

package/controllers/NewsController.js

@@ -0,0 +1,102 @@
+class NewsController {
+    constructor(newsService, statService, config) {
+        this.newsService = newsService;
+        this.statService = statService;
+        this.config = config; // Digunakan untuk passing config ke view (e.g. baseUrl)
+    }
+
+    // --- Route Publik ---
+    async listPublic(req, res) {
+        try {
+            const { rows: posts, count: total } = await this.newsService.getAllPosts(req.query.page);
+
+            res.status(200).json({
+                success: true,
+                data: posts,
+                total: total,
+                page: req.query.page
+            })
+
+            // res.render('list', { posts, total, baseUrl: req.baseUrl });
+        } catch (error) {
+            res.status(500).json({
+                succses: false,
+                error: 'Error loading news list.'
+            });
+        }
+    }
+
+    async getDetail(req, res) {
+        try {
+            const post = await this.newsService.getPostBySlug(req.params.slug);
+            if (!post) {
+                return res.status(404).json({
+                    succses: false,
+                    error: 'news tidak ditemukan'
+                });
+            }
+
+            res.status(200).json({
+                success: true,
+                data: post
+            })
+            
+            // Render detail view
+            // res.render('detail', { post, baseUrl: req.baseUrl });
+        } catch (error) {
+            // res.status(500).send('Error loading post detail.');
+            res.status(500).json({
+                succses: false,
+                error: 'gagal melihat news'
+            });
+        }
+    }
+    
+    // --- Route Admin (CRUD) ---
+    async adminList(req, res) {
+        // Logic ambil data dengan status DRAFT atau PUBLISHED untuk admin
+        const { rows: posts } = await this.newsService.getAllPosts(req.query.page, 10, ['DRAFT', 'PUBLISHED']);
+
+        res.status(200).json({
+            success: true,
+            data: posts
+        })
+
+        //render
+        // res.render('admin/list', { posts, baseUrl: req.baseUrl });
+    }
+
+    async createPost(req, res) {
+        try {
+            // Asumsi req.body.content adalah array of blocks [{blockType, contentValue}, ...]
+            const { title, summary, authorId, status, contentBlocks } = req.body; 
+
+            // Slug harus dibuat sebelum disimpan
+            const slug = title.toLowerCase().replace(/ /g, '-').replace(/[^\w-]+/g, ''); 
+
+            const newNews = await this.newsService.createPost(
+                { title, slug, summary, authorId, status: status || 'DRAFT' },
+                contentBlocks
+            );
+
+            res.status(201).json({
+                success: true,
+                data: newNews
+            })
+
+            // Redirect ke halaman daftar admin atau detail admin
+            // res.redirect(this.config.adminRoutePrefix + '/'); 
+        } catch (error) {
+            console.error(error);
+            // res.status(500).send('Gagal membuat berita.');
+            res.status(500).json({
+                succses: false,
+                error: 'gagal membuat news'
+            });
+        }
+    }
+    
+    // ... Tambahkan updatePost, deletePost, dll.
+}
+
+module.exports = NewsController;

package/controllers/StatController.js

@@ -0,0 +1,36 @@
+// controllers/StatController.js
+
+class StatController {
+    constructor(statService) {
+        this.statService = statService;
+    }
+
+    // Middleware untuk pelacakan kunjungan
+    async trackVisitMiddleware(req, res, next) {
+        const { slug } = req.params;
+        
+        // Ambil post ID (idealnya dilakukan oleh service sebelum dipanggil)
+        // Untuk demo, kita asumsikan kita punya newsId dari service atau middleware sebelumnya.
+        // **REAL-WORLD:** Anda harus mencari newsId berdasarkan slug di sini atau di service.
+        const newsId = 1; // Contoh: Asumsi newsId ditemukan
+
+        const sessionId = req.sessionID || req.ip; // Gunakan sesi atau IP untuk unique ID
+        
+        if (newsId) {
+            await this.statService.trackVisit(newsId, sessionId);
+        }
+        
+        next(); // Lanjutkan ke controller NewsController.getDetail
+    }
+
+    async getTrendingApi(req, res) {
+        try {
+            const posts = await this.statService.getTrendingPosts();
+            res.json(posts);
+        } catch (error) {
+            res.status(500).json({ error: 'Failed to retrieve trending data.' });
+        }
+    }
+}
+
+module.exports = StatController;

package/index.js

@@ -0,0 +1,73 @@
+const express = require('express');
+const initModels = require('./models'); // Mengimpor inisialisasi model dan koneksi DB
+const initServices = require('./services'); // Mengimpor semua Services (CRUD, Stat)
+const setupRoutes = require('./routes'); // Mengimpor fungsi setup router
+
+/**
+ * Fungsi utama package yang di-export.
+ * @param {object} dbConfig - Konfigurasi koneksi database dari aplikasi pengguna.
+ * @param {object} options - Opsi tambahan (misalnya, nama folder views pengguna).
+ * @returns {express.Router} Router Express yang sudah terkonfigurasi.
+ */
+// index.js (Revisi Akhir)
+
+const express = require('express');
+// Pastikan Anda telah mendefinisikan dan mengimpor fungsi-fungsi ini
+const initModels = require('./models'); 
+const initServices = require('./services'); 
+const setupRoutes = require('./routes');
+const mergeConfig = require('./config'); // Gunakan fungsi mergeConfig yang sudah kita buat
+
+/**
+ * Fungsi utama package yang di-export.
+ * @param {object} dbConfig - Konfigurasi koneksi database dari aplikasi pengguna.
+ * @param {object} userOptions - Opsi tambahan (misalnya, autoMigrate) dari pengguna.
+ * @returns {express.Router} Router Express yang sudah terkonfigurasi.
+ */
+module.exports = async (dbConfig, userOptions = {}) => { // <<< KUNCI 1: Jadikan ASYNC
+    
+    // 1. Validasi dan Konfigurasi
+    if (!dbConfig || !dbConfig.database) {
+        throw new Error('News module requires database configuration (dbConfig).');
+    }
+    
+    // Gabungkan konfigurasi database dan opsi pengguna (walaupun di sini kita hanya menggunakan dbConfig)
+    const finalConfig = mergeConfig({
+        ...userOptions,
+        db: dbConfig 
+    });
+
+    // 2. Inisialisasi Koneksi Database dan Model
+    const db = initModels(finalConfig.db); 
+    
+    // 3. Sinkronisasi Tabel (Pembuatan Tabel Otomatis)
+    // Secara default, kita asumsikan sinkronisasi ON. Pengguna bisa menonaktifkannya dengan { autoMigrate: false }
+    if (finalConfig.autoMigrate !== false) {
+        try {
+            console.log('News module: Synchronizing database tables...');
+            // Memanggil syncTables yang didefinisikan di models/index.js
+            await db.syncTables({ alter: true }); 
+            console.log('News module: Synchronization complete.');
+        } catch (error) {
+            console.error('ERROR: News module failed to synchronize database tables.', error);
+            // Anda bisa memilih untuk melempar error agar server tidak berjalan tanpa tabel
+            throw error; 
+        }
+    }
+    
+    // 4. Inisialisasi Services (Injeksi Dependencies)
+    const services = initServices(db);
+
+    // 5. Setup Router Express
+    const router = express.Router();
+    
+    // Middleware dasar untuk parsing body (penting untuk CRUD)
+    router.use(express.json());
+    router.use(express.urlencoded({ extended: true }));
+
+    // 6. Setup Router dan Controllers
+    // Route diatur, Controllers menggunakan Services dan finalConfig
+    setupRoutes(router, services, finalConfig);
+
+    return router;
+};

package/models/ContentNews.js

@@ -0,0 +1,46 @@
+// models/ContentNews.js
+
+const { DataTypes } = require('sequelize');
+
+module.exports = (sequelize) => {
+    const ContentNews = sequelize.define('ContentNews', {
+        id: {
+            type: DataTypes.INTEGER,
+            primaryKey: true,
+            autoIncrement: true,
+        },
+        newsId: {
+            type: DataTypes.INTEGER,
+            allowNull: false,
+        },
+        order: {
+            type: DataTypes.INTEGER,
+            allowNull: false,
+        },
+        blockType: {
+            type: DataTypes.ENUM(
+                'PARAGRAPH', 
+                'IMAGE', 
+                'VIDEO', 
+                'SUBHEADING'
+            ),
+            allowNull: false,
+        },
+        contentValue: {
+            type: DataTypes.TEXT,
+            allowNull: false,
+        },
+        caption: {
+            type: DataTypes.STRING(255), 
+            allowNull: true,
+        }
+    }, {
+        tableName: 'content_news',
+        timestamps: false,
+        indexes: [
+            { fields: ['newsId', 'order'] } 
+        ]
+    });
+
+    return ContentNews;
+};

package/models/News.js

@@ -0,0 +1,48 @@
+// models/News.js
+
+const { DataTypes } = require('sequelize');
+
+module.exports = (sequelize) => {
+    const News = sequelize.define('News', {
+        id: {
+            type: DataTypes.INTEGER,
+            primaryKey: true,
+            autoIncrement: true,
+        },
+        title: {
+            type: DataTypes.STRING(255),
+            allowNull: false,
+        },
+        slug: {
+            type: DataTypes.STRING(255),
+            allowNull: false,
+            unique: true,
+        },
+        authorName: {
+            type: DataTypes.STRING(50), 
+            allowNull: false,
+        },
+        category: {
+            type: DataTypes.STRING(100),
+            allowNull: true,
+        },
+        imagePath: {
+            type: DataTypes.STRING(255),
+            allowNull: true,
+        },
+        status: {
+            type: DataTypes.ENUM('DRAFT', 'PUBLISHED', 'ARCHIVED'),
+            defaultValue: 'DRAFT',
+            allowNull: false,
+        },
+        publishedAt: {
+            type: DataTypes.DATE,
+            allowNull: true,
+        }
+    }, {
+        tableName: 'news', 
+        timestamps: true,
+    });
+
+    return News;
+};

package/models/VisitorLog.js

@@ -0,0 +1,35 @@
+// models/VisitorLog.js
+
+const { DataTypes } = require('sequelize');
+
+module.exports = (sequelize) => {
+    const VisitorLog = sequelize.define('VisitorLog', {
+        id: {
+            type: DataTypes.INTEGER,
+            primaryKey: true,
+            autoIncrement: true,
+        },
+        newsId: {
+            type: DataTypes.INTEGER,
+            allowNull: false,
+        },
+        sessionId: {
+            type: DataTypes.STRING(100), 
+            allowNull: false,
+        },
+        visitedAt: {
+            type: DataTypes.DATE,
+            defaultValue: DataTypes.NOW,
+            allowNull: false,
+        }
+    }, {
+        tableName: 'visitor_logs', 
+        timestamps: false, 
+        indexes: [
+            { fields: ['visitedAt'] },
+            { unique: true, fields: ['newsId', 'sessionId'] } 
+        ]
+    });
+
+    return VisitorLog;
+};

package/models/index.js

@@ -0,0 +1,61 @@
+// models/index.js
+
+const { Sequelize } = require('sequelize');
+const NewsModel = require('./News');
+const ContentNewsModel = require('./ContentNews');
+const VisitorLogModel = require('./VisitorLog');
+
+module.exports = (config) => {
+    // Inisialisasi Sequelize dengan konfigurasi dari aplikasi pengguna
+    const sequelize = new Sequelize(config.database, config.username, config.password, {
+        host: config.host,
+        dialect: 'mysql',
+        logging: false, // Matikan logging SQL
+    });
+
+    const db = {};
+
+    db.News = NewsModel(sequelize);
+    db.ContentNews = ContentNewsModel(sequelize);
+    db.VisitorLog = VisitorLogModel(sequelize);
+
+    
+    db.News.hasMany(db.ContentNews, {
+        foreignKey: 'newsId',
+        as: 'blocks', 
+        onDelete: 'CASCADE' 
+    });
+    db.ContentNews.belongsTo(db.News, {
+        foreignKey: 'newsId',
+        as: 'newsItem'
+    });
+
+    
+    db.News.hasMany(db.VisitorLog, {
+        foreignKey: 'newsId',
+        as: 'visits',
+        onDelete: 'CASCADE' 
+    });
+    db.VisitorLog.belongsTo(db.News, {
+        foreignKey: 'newsId',
+        as: 'newsItem'
+    });
+
+
+    // --- PENAMBAHAN KUNCI UNTUK SINKRONISASI ---
+    /**
+     * Metode untuk mensinkronisasi model dengan tabel database.
+     * @param {object} options - Opsi sinkronisasi Sequelize (e.g., { alter: true } atau { force: true }).
+     */
+    db.syncTables = async (options = { alter: true }) => {
+        // Kami menggunakan { alter: true } secara default, yang akan membuat tabel jika belum ada
+        // dan mencoba mengubah kolom yang ada agar sesuai dengan definisi model, tanpa menghapus data.
+        await sequelize.sync(options);
+    };
+    // ----------------------------------------------
+
+    db.sequelize = sequelize;
+    db.Sequelize = Sequelize;
+
+    return db;
+};

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "news-cms-module",
+  "version": "0.0.1",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "Package CRUD Berita modular dengan statistik",
+  "dependencies": {
+    "dotenv": "^17.2.3",
+    "ejs": "^3.1.10",
+    "express": "^5.1.0",
+    "mysql2": "^3.15.1",
+    "path": "^0.12.7",
+    "sequelize": "^6.37.7"
+  }
+}

package/routes/index.js

@@ -0,0 +1,74 @@
+// routes/index.js
+
+const express = require('express');
+const NewsController = require('../controllers/NewsController');
+const StatController = require('../controllers/StatController');
+const path = require('path');
+
+/**
+ * Setup semua route untuk package.
+ * @param {express.Router} router - Router Express yang sudah ada.
+ * @param {object} services - Semua services yang telah diinisialisasi.
+ * @param {object} config - Konfigurasi package lengkap.
+ */
+module.exports = (router, services, config) => {
+    // Inisialisasi Controllers dengan services dan config yang dibutuhkan
+    const newsController = new NewsController(services.news, services.stat, config);
+    const statController = new StatController(services.stat);
+
+    // 1. Ekspos Aset Statis (CSS)
+    // Misalnya, package diakses di /berita-kami, maka aset diakses di /berita-kami/nc-assets
+    // router.use(config.assetsUrlPrefix, express.static(config.assetsPath));
+
+    // 2. Route Publik (Front-end)
+    // Route ini menggunakan prefix yang ditentukan oleh pengguna (default: '/')
+    // router.get(config.publicRoutePrefix, newsController.listPublic.bind(newsController));
+
+    // 2. Route Publik (READ-ONLY API)
+    // Gunakan endpoint yang jelas: /list, /trending, /:slug
+    router.get(config.publicRoutePrefix + 'list', newsController.listPublic.bind(newsController));
+    
+    // Route detail berita, termasuk tracking middleware
+    router.get(`${config.publicRoutePrefix}post/:slug`, 
+            statController.trackVisitMiddleware.bind(statController), 
+            newsController.getDetail.bind(newsController));
+    
+    // Route detail berita (termasuk tracking middleware)
+    // PERHATIAN: Di controller, Anda harus memastikan baseUrl dikirim ke view
+    // router.get(`${config.publicRoutePrefix}:slug`, statController.trackVisitMiddleware.bind(statController), newsController.getDetail.bind(newsController));
+
+    // 3. Route Admin (CRUD)
+    // Route ini menggunakan prefix admin yang ditentukan oleh pengguna (default: '/admin')
+    const adminRouter = express.Router();
+    // Middleware otentikasi admin bisa ditambahkan di sini (user harus menyediakannya!)
+
+    // GET /admin/list (Membaca semua post, termasuk DRAFT)
+    adminRouter.get('/list', newsController.adminList.bind(newsController)); 
+    
+    // GET /admin/:id (Membaca detail post untuk editing)
+    adminRouter.get('/:id', newsController.getDetail.bind(newsController)); 
+    
+    // POST /admin/create (Membuat berita baru)
+    adminRouter.post('/create', newsController.createPost.bind(newsController)); 
+    
+    // PUT/PATCH /admin/update/:id (Memperbarui berita)
+    // adminRouter.put('/update/:id', newsController.updatePost.bind(newsController)); 
+
+    // DELETE /admin/delete/:id (Menghapus berita)
+    // adminRouter.delete('/delete/:id', newsController.deletePost.bind(newsController)); 
+
+    // Pasang router admin ke prefix yang ditentukan pengguna (default: '/admin')
+    router.use(config.adminRoutePrefix, adminRouter);
+    
+    // adminRouter.get('/', newsController.adminList.bind(newsController));
+    // adminRouter.post('/create', newsController.createPost.bind(newsController));
+    // // ... Tambahkan route admin lain (/edit/:id, /delete/:id)
+
+    // router.use(config.adminRoutePrefix, adminRouter);
+
+
+    // 4. Route API (Untuk data trending)
+    router.get('/api/trending', statController.getTrendingApi.bind(statController));
+
+    // Router telah siap di file index.js
+};

package/services/NewsService.js

@@ -0,0 +1,55 @@
+class NewsService {
+    constructor(NewsModel, ContentNewsModel) {
+        this.News = NewsModel;
+        this.ContentNews = ContentNewsModel;
+    }
+
+    // --- Operasi READ (Membaca) ---
+    async getAllPosts(page = 1, limit = 10, status = 'PUBLISHED') {
+        // Logika untuk mengambil daftar berita dengan pagination
+        const offset = (page - 1) * limit;
+        return this.News.findAndCountAll({
+            where: { status },
+            limit: limit,
+            offset: offset,
+            order: [['publishedAt', 'DESC']],
+        });
+    }
+
+    async getPostBySlug(slug) {
+        // Mengambil berita beserta semua blok kontennya
+        return this.News.findOne({
+            where: { slug, status: 'PUBLISHED' },
+            include: [{
+                model: this.ContentNews,
+                as: 'blocks',
+                order: [['order', 'ASC']] // Pastikan konten diurutkan
+            }]
+        });
+    }
+
+    // --- Operasi CREATE & UPDATE ---
+    async createPost(newsData, contentBlocks) {
+        return this.News.sequelize.transaction(async (t) => {
+            const newsItem = await this.News.create(newsData, { transaction: t });
+
+            const blocks = contentBlocks.map((block, index) => ({
+                ...block,
+                newsId: newsItem.id,
+                order: index + 1
+            }));
+
+            await this.ContentNews.bulkCreate(blocks, { transaction: t });
+            return newsItem;
+        });
+    }
+
+    // --- Operasi DELETE ---
+    async deletePost(id) {
+        // Karena kita menggunakan onDelete: 'CASCADE' di Models,
+        // menghapus News akan otomatis menghapus ContentNews dan VisitorLog
+        return this.News.destroy({ where: { id } });
+    }
+}
+
+module.exports = NewsService;

package/services/StatService.js

@@ -0,0 +1,55 @@
+// services/StatService.js
+
+const { Op, literal } = require('sequelize');
+
+class StatService {
+    constructor(VisitorLogModel, NewsModel) {
+        this.VisitorLog = VisitorLogModel;
+        this.News = NewsModel;
+    }
+
+    async trackVisit(newsId, sessionId) {
+        // Mencoba membuat entri unik (newsId, sessionId). Jika sudah ada, Sequelize akan melempar error unik.
+        try {
+            await this.VisitorLog.create({
+                newsId: newsId,
+                sessionId: sessionId,
+                visitedAt: new Date()
+            });
+            return true;
+        } catch (error) {
+            // Ini biasanya terjadi karena pelanggaran unique constraint (pengunjung yang sama mengklik lagi)
+            // Di sini kita bisa mengabaikan error atau logging.
+            return false;
+        }
+    }
+
+    async getTrendingPosts(timeframeHours = 24, limit = 10) {
+        const cutOffTime = new Date(new Date() - timeframeHours * 60 * 60 * 1000);
+
+        // Menggunakan Sequelize untuk melakukan GROUP BY dan COUNT
+        const trendingLogs = await this.VisitorLog.findAll({
+            attributes: [
+                'newsId',
+                [literal('COUNT(DISTINCT sessionId)'), 'uniqueVisits'] // Hitung sesi unik
+            ],
+            where: {
+                visitedAt: { [Op.gte]: cutOffTime } // Filter berdasarkan waktu
+            },
+            group: ['newsId'],
+            order: [[literal('uniqueVisits'), 'DESC']], // Urutkan berdasarkan kunjungan terbanyak
+            limit: limit
+        });
+
+        const newsIds = trendingLogs.map(log => log.newsId);
+        
+        // Ambil data berita lengkapnya
+        return this.News.findAll({
+            where: { id: newsIds, status: 'PUBLISHED' },
+            // Tambahkan order agar urutan trending tetap terjaga
+            order: [[literal(`FIELD(id, ${newsIds.join(',')})`)]], // MySQL specific ordering
+        });
+    }
+}
+
+module.exports = StatService;

package/services/index.js

@@ -0,0 +1,17 @@
+// services/index.js
+
+const NewsService = require('./NewsService');
+const StatService = require('./StatService');
+
+/**
+ * Menginisialisasi semua service dan menyuntikkan model database.
+ * @param {object} db - Objek yang berisi semua model Sequelize yang terkoneksi (News, ContentNews, VisitorLog).
+ * @returns {object} Objek yang berisi semua service yang siap digunakan.
+ */
+module.exports = (db) => {
+    return {
+        news: new NewsService(db.News, db.ContentNews), // NewsService butuh News dan ContentNews
+        stat: new StatService(db.VisitorLog, db.News), // StatService butuh VisitorLog dan News
+        db: db // Mungkin perlu mengakses Sequelize instance (opsional)
+    };
+};