cleancode-e 1.0.0

package/README.md

@@ -0,0 +1,181 @@
+<div align="center">
+
+# ⚡ cleancode-e
+
+**CLI Generator untuk project backend Fastify — siap pakai dalam hitungan detik.**
+
+[![npm version](https://img.shields.io/npm/v/cleancode-e?color=cyan&style=flat-square)](https://www.npmjs.com/package/cleancode-e)
+[![license](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)
+[![node](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square)](https://nodejs.org)
+
+</div>
+
+---
+
+## Apa itu cleancode-e?
+
+`cleancode-e` adalah CLI generator yang men-scaffold project backend [Fastify](https://fastify.dev) secara interaktif — lengkap dengan struktur folder siap produksi, pilihan database (MongoDB / MySQL / tanpa database), dan auto-install dependency.
+
+Terinspirasi dari Artisan (Laravel) dan Create-React-App, tapi untuk ekosistem **Node.js + Fastify**.
+
+---
+
+## Quickstart
+
+```bash
+npx cleancode-e
+```
+
+> Tidak perlu install dulu. Jalankan langsung, ikuti promptnya.
+
+---
+
+## Cara Pakai
+
+```bash
+npx cleancode-e
+
+# atau jika install global:
+npm install -g cleancode-e
+cleancode-e
+```
+
+Ikuti prompt interaktifnya:
+
+```
+┌   cleancode-e CLI Generator
+│
+◇  Nama project kamu:
+│  my-api
+│
+◇  Pilih database:
+│  ● Tidak pakai database (in-memory)
+│  ○ MongoDB (Mongoose)
+│  ○ MySQL (Sequelize + mysql2)
+│
+◇  Pakai nodemon untuk auto-reload saat development?
+│  ● Ya  ○ Tidak
+│
+└  folder berhasil dibuat, Selamat berkarya! masbro 🚀
+```
+
+---
+
+## Struktur Project yang Dihasilkan
+
+```
+my-api/
+├── app.js                          # Entry point server Fastify
+├── package.json                    # Scripts & dependencies
+├── .env.example                    # Template environment variables
+│
+├── routes/
+│   ├── example.userRoute.js        # Contoh route GET & POST /users
+│   └── readme.txt                  # Panduan penggunaan folder routes
+│
+├── controllers/
+│   ├── example.userController.js   # Contoh logic controller
+│   └── readme.txt
+│
+├── models/
+│   ├── example.userModel.js        # Skema User (Mongoose / Sequelize)
+│   └── readme.txt
+│
+├── config/
+│   ├── db.js                       # Koneksi database (jika dipilih)
+│   └── readme.txt
+│
+├── plugins/
+│   ├── example.corsPlugin.js       # Contoh plugin CORS
+│   └── readme.txt
+│
+└── middleware/
+    ├── example.authMiddleware.js   # Contoh middleware autentikasi
+    └── readme.txt
+```
+
+---
+
+## Dependency yang Diinstall Otomatis
+
+| Pilihan | Package yang diinstall |
+|---|---|
+| Semua project | `fastify` |
+| MongoDB | + `mongoose` |
+| MySQL | + `sequelize`, `mysql2` |
+| Nodemon (jika Ya) | `nodemon` (devDependency) |
+
+---
+
+## Setup Setelah Generate
+
+### 1. Tanpa Database
+Langsung jalankan:
+```bash
+cd my-api
+npm start
+# → http://localhost:3000
+```
+
+### 2. MongoDB
+```bash
+cd my-api
+
+# Rename dan isi .env
+cp .env.example .env
+# Edit MONGO_URI di .env:
+# MONGO_URI=mongodb://localhost:27017/my-api
+# atau MongoDB Atlas:
+# MONGO_URI=mongodb+srv://user:pass@cluster.mongodb.net/my-api
+
+npm start
+```
+
+### 3. MySQL
+```bash
+cd my-api
+
+# Buat database dulu di MySQL:
+# CREATE DATABASE my_api;
+
+cp .env.example .env
+# Edit .env:
+# DB_HOST=localhost
+# DB_NAME=my_api
+# DB_USER=root
+# DB_PASS=yourpassword
+
+npm start
+# Sequelize akan auto-sync tabel saat pertama kali jalan
+```
+
+---
+
+## Scripts
+
+| Command | Keterangan |
+|---|---|
+| `npm start` | Jalankan server (production) |
+| `npm run dev` | Jalankan dengan nodemon (development) |
+
+---
+
+## Syarat
+
+- Node.js `>= 18`
+- npm `>= 8`
+
+---
+
+## Tech Stack
+
+- **[Fastify](https://fastify.dev)** — Web framework Node.js ultra-cepat
+- **[@clack/prompts](https://github.com/natemoo-re/clack)** — Prompt CLI yang elegan
+- **[execa](https://github.com/sindresorhus/execa)** — Shell command runner
+- **[picocolors](https://github.com/alexeyraspopov/picocolors)** — Terminal color output
+
+---
+
+## Lisensi
+
+MIT © cleancode-e contributors

package/bin/index.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../src/cli.js";

package/package.json

@@ -0,0 +1,15 @@
+{
+    "name": "cleancode-e",
+    "version": "1.0.0",
+    "description": "CLI generator untuk project backend Fastify siap pakai",
+    "keywords": ["fastify", "cli", "generator", "scaffold", "backend", "nodejs"],
+    "type": "module",
+    "bin": {
+        "cleancode-e": "./bin/index.js"
+    },
+    "dependencies": {
+        "@clack/prompts": "^0.7.0",
+        "execa": "^8.0.1",
+        "picocolors": "^1.0.0"
+    }
+}

package/src/cli.js

@@ -0,0 +1,159 @@
+import { intro, outro, text, select, confirm, spinner, note } from "@clack/prompts";
+import { execa } from "execa";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "node:url";
+import colors from "picocolors";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+async function main() {
+    console.clear();
+    intro(colors.bgCyan(colors.black(" cleancode-e CLI Generator ")));
+
+    const projectName = await text({
+        message: "Nama project kamu:",
+        placeholder: "contoh: my-api",
+        validate: (value) => {
+            if (!value) return "Nama project tidak boleh kosong";
+            if (value.includes(" ")) return "Nama project tidak boleh mengandung spasi";
+            if (value.length < 3) return "Nama project minimal 3 karakter";
+            if (/\d/.test(value)) return "Nama project tidak boleh mengandung angka";
+            if (fs.existsSync(value)) return "Folder dengan nama itu sudah ada";
+        },
+    });
+
+    if (typeof projectName === "symbol") {
+        outro(colors.red("Dibatalkan."));
+        process.exit(0);
+    }
+
+    const database = await select({
+        message: "Pilih database:",
+        options: [
+            { value: "none", label: "Tidak pakai database (in-memory)" },
+            { value: "mongo", label: "MongoDB (Mongoose)" },
+            { value: "mysql", label: "MySQL (Sequelize + mysql2)" },
+        ],
+    });
+
+    if (typeof database === "symbol") {
+        outro(colors.red("Dibatalkan."));
+        process.exit(0);
+    }
+
+    const useNodemon = await confirm({
+        message: "Pakai nodemon untuk auto-reload saat development?",
+        initialValue: true,
+    });
+
+    if (typeof useNodemon === "symbol") {
+        outro(colors.red("Dibatalkan."));
+        process.exit(0);
+    }
+
+    const targetDir = path.resolve(projectName);
+    const templateDir = path.join(__dirname, "templates");
+
+    const s = spinner();
+    s.start("Menyiapkan struktur project...");
+
+    try {
+        const dirs = ["routes", "controllers", "models", "config", "plugins", "middleware"];
+        for (const dir of dirs) {
+            fs.mkdirSync(path.join(targetDir, dir), { recursive: true });
+        }
+
+        const from = (src) => path.join(templateDir, src);
+        const to = (dest) => path.join(targetDir, dest);
+        const cp = (src, dest) => fs.copyFileSync(from(src), to(dest));
+
+        cp(`app.${database}.js`, "app.js");
+        cp(".env.example", ".env.example");
+
+        cp("routes/example.userRoute.js", "routes/example.userRoute.js");
+        cp("routes/readme.txt", "routes/readme.txt");
+        cp("controllers/readme.txt", "controllers/readme.txt");
+        cp("models/readme.txt", "models/readme.txt");
+        cp("config/readme.txt", "config/readme.txt");
+        cp("plugins/readme.txt", "plugins/readme.txt");
+        cp("plugins/example.corsPlugin.js", "plugins/example.corsPlugin.js");
+        cp("middleware/readme.txt", "middleware/readme.txt");
+        cp("middleware/example.authMiddleware.js", "middleware/example.authMiddleware.js");
+
+        if (database === "mongo") {
+            cp("config/db.mongo.js", "config/db.js");
+            cp("models/example.userModel.mongo.js", "models/example.userModel.js");
+            cp("controllers/example.userController.mongo.js", "controllers/example.userController.js");
+        } else if (database === "mysql") {
+            cp("config/db.mysql.js", "config/db.js");
+            cp("models/example.userModel.mysql.js", "models/example.userModel.js");
+            cp("controllers/example.userController.mysql.js", "controllers/example.userController.js");
+        } else {
+            cp("controllers/example.userController.none.js", "controllers/example.userController.js");
+        }
+
+        const deps = { fastify: "latest" };
+        if (database === "mongo") deps.mongoose = "latest";
+        if (database === "mysql") {
+            deps.sequelize = "latest";
+            deps.mysql2 = "latest";
+        }
+
+        fs.writeFileSync(
+            to("package.json"),
+            JSON.stringify({
+                name: projectName,
+                version: "1.0.0",
+                type: "module",
+                main: "app.js",
+                scripts: {
+                    start: "node app.js",
+                    dev: useNodemon ? "nodemon app.js" : "node --watch app.js",
+                },
+                dependencies: deps,
+            }, null, 2)
+        );
+
+        s.stop("Struktur project berhasil dibuat!");
+
+        const installSpinner = spinner();
+        installSpinner.start("Menginstall dependencies (ini mungkin memakan waktu >_<)...");
+
+        const installList = ["fastify"];
+        if (database === "mongo") installList.push("mongoose");
+        if (database === "mysql") installList.push("sequelize", "mysql2");
+
+        await execa("npm", ["install", ...installList], { cwd: targetDir });
+
+        if (useNodemon) {
+            await execa("npm", ["install", "--save-dev", "nodemon"], { cwd: targetDir });
+        }
+
+        installSpinner.stop("Dependencies berhasil diinstall!");
+
+        note(
+            [
+                `Project berhasil dibuat di: ${colors.cyan(targetDir)}`,
+                "",
+                `  cd ${projectName}`,
+                `  npm start`,
+                "",
+                database !== "none"
+                    ? `Isi ${colors.yellow(".env.example")} lalu rename jadi ${colors.yellow(".env")}`
+                    : "",
+            ].filter(Boolean).join("\n"),
+            "Selesai!"
+        );
+
+        outro(colors.green("folder berhasil dibuat, Selamat berkarya! masbro 🚀"));
+    } catch (err) {
+        s.stop(colors.red("Terjadi kesalahan!"));
+        console.error(err);
+        outro(colors.red("Proses pembuatan project gagal."));
+        process.exit(1);
+    }
+}
+
+main();

package/src/templates/.env.example

@@ -0,0 +1,10 @@
+PORT=3000
+
+# MongoDB
+MONGO_URI=mongodb://localhost:27017/myapp
+
+# MySQL
+DB_HOST=localhost
+DB_NAME=myapp
+DB_USER=root
+DB_PASS=

package/src/templates/app.mongo.js

@@ -0,0 +1,18 @@
+import Fastify from 'fastify';
+import { connectDB } from './config/db.js';
+import userRoutes from './routes/userRoutes.js';
+
+const fastify = Fastify({ logger: true });
+
+fastify.register(userRoutes);
+
+const start = async () => {
+    try {
+        await connectDB();
+        await fastify.listen({ port: process.env.PORT || 3000, host: '0.0.0.0' });
+    } catch (err) {
+        fastify.log.error(err);
+        process.exit(1);
+    }
+};
+start();

package/src/templates/app.mysql.js

@@ -0,0 +1,21 @@
+import Fastify from 'fastify';
+import sequelize from './config/db.js';
+import userRoutes from './routes/userRoutes.js';
+import './models/User.js';
+
+const fastify = Fastify({ logger: true });
+
+fastify.register(userRoutes);
+
+const start = async () => {
+    try {
+        await sequelize.authenticate();
+        await sequelize.sync();
+        console.log('MySQL connected & synced');
+        await fastify.listen({ port: process.env.PORT || 3000, host: '0.0.0.0' });
+    } catch (err) {
+        fastify.log.error(err);
+        process.exit(1);
+    }
+};
+start();

package/src/templates/app.none.js

@@ -0,0 +1,16 @@
+import Fastify from 'fastify';
+import userRoutes from './routes/userRoutes.js';
+
+const fastify = Fastify({ logger: true });
+
+fastify.register(userRoutes);
+
+const start = async () => {
+    try {
+        await fastify.listen({ port: process.env.PORT || 3000, host: '0.0.0.0' });
+    } catch (err) {
+        fastify.log.error(err);
+        process.exit(1);
+    }
+};
+start();

package/src/templates/config/db.mongo.js

@@ -0,0 +1,6 @@
+import mongoose from 'mongoose';
+
+export async function connectDB() {
+    await mongoose.connect(process.env.MONGO_URI || 'mongodb://localhost:27017/myapp');
+    console.log('MongoDB connected');
+}

package/src/templates/config/db.mysql.js

@@ -0,0 +1,14 @@
+import { Sequelize } from 'sequelize';
+
+const sequelize = new Sequelize(
+    process.env.DB_NAME || 'myapp',
+    process.env.DB_USER || 'root',
+    process.env.DB_PASS || '',
+    {
+        host: process.env.DB_HOST || 'localhost',
+        dialect: 'mysql',
+        logging: false,
+    }
+);
+
+export default sequelize;

package/src/templates/config/readme.txt

@@ -0,0 +1,4 @@
+config/
+Folder ini berisi konfigurasi koneksi database dan environment.
+File db.js mengekspor koneksi yang siap dipakai di seluruh aplikasi.
+Simpan kredensial sensitif di file .env dan jangan di-commit ke git.

package/src/templates/controllers/example.userController.mongo.js

@@ -0,0 +1,11 @@
+import User from '../models/example.userModel.js';
+
+export async function getUsers(request, reply) {
+    const users = await User.find();
+    return reply.send({ status: 'success', data: users });
+}
+
+export async function createUser(request, reply) {
+    const user = await User.create(request.body);
+    return reply.code(201).send({ status: 'success', data: user });
+}

package/src/templates/controllers/example.userController.mysql.js

@@ -0,0 +1,11 @@
+import User from '../models/example.userModel.js';
+
+export async function getUsers(request, reply) {
+    const users = await User.findAll();
+    return reply.send({ status: 'success', data: users });
+}
+
+export async function createUser(request, reply) {
+    const user = await User.create(request.body);
+    return reply.code(201).send({ status: 'success', data: user });
+}

package/src/templates/controllers/example.userController.none.js

@@ -0,0 +1,12 @@
+const users = [];
+
+export async function getUsers(request, reply) {
+    return reply.send({ status: 'success', data: users });
+}
+
+export async function createUser(request, reply) {
+    const { name, email } = request.body;
+    const user = { id: users.length + 1, name, email };
+    users.push(user);
+    return reply.code(201).send({ status: 'success', data: user });
+}

package/src/templates/controllers/readme.txt

@@ -0,0 +1,4 @@
+controllers/
+Folder ini berisi logika bisnis untuk setiap resource.
+Controller menerima request dari route dan berinteraksi dengan model.
+Kembalikan response yang konsisten: { status, data } atau { status, message }.

package/src/templates/middleware/example.authMiddleware.js

@@ -0,0 +1,9 @@
+export async function authMiddleware(request, reply) {
+    const token = request.headers['authorization'];
+    if (!token) {
+        return reply.code(401).send({ status: 'error', message: 'Unauthorized' });
+    }
+    // TODO: verifikasi token JWT di sini
+    // const decoded = jwt.verify(token.replace('Bearer ', ''), process.env.JWT_SECRET);
+    // request.user = decoded;
+}

package/src/templates/middleware/readme.txt

@@ -0,0 +1,5 @@
+middleware/
+Folder ini berisi fungsi middleware (hook) Fastify.
+Middleware biasanya digunakan untuk autentikasi, logging, dan validasi request.
+Daftarkan sebagai hook di app.js: fastify.addHook('preHandler', myMiddleware)
+Penamaan file: namaMiddleware.middleware.js  →  contoh: auth.middleware.js

package/src/templates/models/example.userModel.mongo.js

@@ -0,0 +1,9 @@
+import mongoose from 'mongoose';
+
+const UserSchema = new mongoose.Schema({
+    name: { type: String, required: true },
+    email: { type: String, required: true, unique: true },
+    createdAt: { type: Date, default: Date.now },
+});
+
+export default mongoose.model('User', UserSchema);

package/src/templates/models/example.userModel.mysql.js

@@ -0,0 +1,12 @@
+import { DataTypes } from 'sequelize';
+import sequelize from '../config/db.js';
+
+const User = sequelize.define('User', {
+    name: { type: DataTypes.STRING, allowNull: false },
+    email: { type: DataTypes.STRING, allowNull: false, unique: true },
+}, {
+    tableName: 'users',
+    timestamps: true,
+});
+
+export default User;

package/src/templates/models/readme.txt

@@ -0,0 +1,4 @@
+models/
+Folder ini berisi definisi skema dan model data.
+Setiap file merepresentasikan satu entitas (misal: User, Product).
+Untuk MongoDB gunakan Mongoose Schema, untuk MySQL gunakan Sequelize define().

package/src/templates/plugins/example.corsPlugin.js

@@ -0,0 +1,8 @@
+import cors from '@fastify/cors';
+
+export default async function corsPlugin(fastify) {
+    await fastify.register(cors, {
+        origin: process.env.CORS_ORIGIN || '*',
+        methods: ['GET', 'POST', 'PUT', 'DELETE'],
+    });
+}

package/src/templates/plugins/readme.txt

@@ -0,0 +1,5 @@
+plugins/
+Folder ini berisi plugin Fastify yang didaftarkan ke instance global.
+Gunakan fastify.register() di app.js untuk mendaftarkan plugin.
+Contoh: CORS, rate limiting, JWT auth, Swagger.
+Penamaan file: namaPlugin.plugin.js  →  contoh: cors.plugin.js

package/src/templates/routes/example.userRoute.js

@@ -0,0 +1,6 @@
+import { getUsers, createUser } from '../controllers/example.userController.js';
+
+export default async function userRoutes(fastify) {
+    fastify.get('/users', getUsers);
+    fastify.post('/users', createUser);
+}

package/src/templates/routes/readme.txt

@@ -0,0 +1,4 @@
+routes/
+Folder ini berisi definisi route Fastify.
+Setiap file mendaftarkan satu grup endpoint (misal: userRoutes.js untuk /users).
+Daftarkan semua route di app.js menggunakan fastify.register().