json-db-engine 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,64 @@
+# Changelog
+
+Semua perubahan penting pada project ini akan didokumentasikan di file ini.
+
+Format yang digunakan mengikuti [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) dan versioning mengikuti [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-02-09
+
+### Added
+- ✨ Implementasi Database Class dengan CRUD operations lengkap
+- 📖 READ operation - membaca semua data dari file JSON
+- ➕ CREATE operation - menambah data baru ke database
+- 🔍 FIND operation - mencari data berdasarkan property dan value
+- 🗑️ DELETE operation - menghapus data berdasarkan property dan value
+- 📁 Struktur modular dengan pemisahan logic menjadi functions terpisah
+- 📚 Dokumentasi lengkap dalam README.md
+- 🔧 Package.json dengan script dan metadata lengkap
+- 📜 MIT License
+- 🤝 CONTRIBUTING.md untuk kontributor
+- 🎯 Example.js dengan demonstrasi lengkap semua operasi
+
+### What's Inside
+- `module.js` - Wrapper untuk Node.js fs module
+- `load.js` - Load dan parse data dari file JSON
+- `read.js` - Read data dengan parsing
+- `add.js` - Add/create data baru
+- `find.js` - Find/search data
+- `delete.js` - Delete data
+- `main.js` - Database class (orchestrator)
+- `example.js` - Complete demonstration
+
+### Learning Outcomes
+- ✅ Object-Oriented Programming dengan JavaScript Class
+- ✅ Node.js File System operations
+- ✅ JSON parsing dan stringifying
+- ✅ Array methods: push, filter, find
+- ✅ ES6 Modules (import/export)
+- ✅ Information architecture dan modular code
+- ✅ Git & GitHub basics
+- ✅ Creating documentation
+
+---
+
+## Rencana Versi Berikutnya
+
+### [1.1.0] - Planned
+- [ ] Async/await version untuk non-blocking operations
+- [ ] Update operation untuk edit data existing
+- [ ] Input validation dan error handling yang lebih robust
+- [ ] Schema validation sebelum menyimpan data
+- [ ] Support untuk multiple file types (CSV, XML)
+- [ ] Unit tests dengan Jest
+
+### [2.0.0] - Future Vision
+- [ ] CLI interface untuk interactive database management
+- [ ] Web API dengan Express.js
+- [ ] User authentication & authorization
+- [ ] Database encryption
+- [ ] Performance optimization & caching
+- [ ] Database indexing
+
+---
+
+**Terima kasih telah menggunakan LearnJS!** 🚀

package/CONTRIBUTING.md

@@ -0,0 +1,127 @@
+# Panduan Kontribusi
+
+Terima kasih telah tertarik untuk berkontribusi pada project **LearnJS**! 🎉
+
+## Bagaimana Cara Berkontribusi?
+
+### 1. Fork Repository
+```bash
+# Clone repository Anda
+git clone https://github.com/wa130/json-db-enginee.git
+cd json-db-enginee
+```
+
+### 2. Buat Branch Baru
+```bash
+git checkout -b feature/nama-fitur
+# atau
+git checkout -b fix/nama-bug
+```
+
+### 3. Lakukan Perubahan
+- Pastikan kode Anda clean dan terstruktur dengan baik
+- Ikuti style guide yang ada di project
+- Tambahkan komentar untuk kode yang kompleks
+
+### 4. Test Perubahan Anda
+```bash
+node example.js
+```
+
+### 5. Commit Perubahan
+```bash
+git add .
+git commit -m "feat: deskripsi singkat perubahan"
+# atau
+git commit -m "fix: deskripsi singkat perbaikan"
+```
+
+### 6. Push ke Repository Anda
+```bash
+git push origin feature/nama-fitur
+```
+
+### 7. Buat Pull Request
+- Buka repository Anda di GitHub
+- Klik tombol "Pull Request"
+- Jelaskan perubahan yang Anda buat
+- Tunggu review dari maintainer
+
+## Style Guide
+
+### JavaScript
+- Gunakan `camelCase` untuk variable dan function
+- Gunakan `PascalCase` untuk class
+- Gunakan arrow functions untuk callbacks
+- Tambahkan JSDoc comments untuk functions yang kompleks
+
+### Contoh:
+```javascript
+/**
+ * Mencari data di database
+ * @param {string} path - Path ke file database
+ * @param {string} property - Property yang dicari
+ * @param {*} value - Value yang dicari
+ * @returns {object} - Data yang ditemukan
+ */
+export default function find(path, property, value) {
+    const database = load(path)
+    return database.find((item) => item[property] === value)
+}
+```
+
+## Jenis Kontribusi yang Diharapkan
+
+### Bug Fixes 🐛
+- Perbaikan error atau issues di kode
+- Improvement pada error handling
+- Optimization performance
+
+### Features ✨
+- Fitur baru yang berguna
+- Improvement pada dokumentasi
+- Menambahkan tests
+
+### Documentation 📚
+- Improvement README
+- Menambah contoh penggunaan
+- Memperbaiki typos
+
+## Area yang Bisa Dikontribusi
+
+- [ ] Menambah fitur update (edit data existing)
+- [ ] Implementasi async/await version
+- [ ] Error handling yang lebih robust
+- [ ] Unit tests menggunakan Jest
+- [ ] Dokumentasi yang lebih lengkap
+- [ ] Tutorial video/blog post
+- [ ] Support untuk format file lain (CSV, XML)
+- [ ] CLI interface untuk database
+
+## Sebelum Submit PR
+
+- ✅ Pastikan code tidak ada error
+- ✅ Pastikan code sudah di-test
+- ✅ Pastikan README/documentation updated (jika diperlukan)
+- ✅ Pastikan commit message jelas dan deskriptif
+- ✅ Pastikan tidak ada file yang tidak perlu di-commit
+
+## Code of Conduct
+
+Dalam berkontribusi pada project ini, kami mengharapkan semua kontributor untuk:
+
+- 🤝 Saling menghormati dan membantu
+- 💬 Berkomunikasi dengan jelas dan konstruktif
+- 🎯 Fokus pada improvement quality code
+- 📖 Membaca dan mengikuti guidelines yang ada
+
+## Questions?
+
+Jika Anda memiliki pertanyaan:
+
+1. Buka [GitHub Issues](https://github.com/wa130/json-db-enginee/issues)
+2. Atau hubungi saya di email: nasyuwa648@gmail.com
+
+---
+
+**Happy Contributing!** 🚀✨

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nasyuwa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,303 @@
+# LearnJS - Database Management System
+
+Selamat datang! Ini adalah project pembelajaran saya untuk memahami cara membuat sistem manajemen database sederhana menggunakan JavaScript dan Node.js.
+
+## 📋 Deskripsi Project
+
+Project ini merupakan implementasi **Database Class** dengan operasi **CRUD (Create, Read, Update, Delete)** yang dapat menyimpan dan mengelola data dalam file JSON. Melalui project ini, saya belajar tentang:
+
+- Membuat class dan object-oriented programming di JavaScript
+- Operasi file system (fs) di Node.js
+- Manipulasi dan parsing data JSON
+- Implementasi operasi CRUD
+- ES Modules (import/export)
+- Array methods: `.push()`, `.filter()`, `.find()`
+- Pemisahan logic ke modul-modul terpisah
+
+## 📁 Struktur Project
+
+```
+json-db-enginee/
+├── module.js       # Wrapper untuk module fs
+├── load.js         # Fungsi untuk load data dari file
+├── read.js         # Fungsi untuk membaca data terstruktur
+├── add.js          # Fungsi untuk menambah data
+├── find.js         # Fungsi untuk mencari data
+├── delete.js       # Fungsi untuk menghapus data
+├── main.js         # Class Database (inti aplikasi)
+├── example.js      # Demonstrasi lengkap semua operasi
+├── example.json    # File data (database)
+├── package.json    # Konfigurasi project
+└── README.md       # File dokumentasi ini
+```
+
+## 🚀 Cara Memulai
+
+### Prerequisites
+- Node.js versi 12 atau lebih tinggi
+- Text Editor/IDE (VS Code, dll)
+
+### Install Dependencies
+```bash
+npm install
+```
+
+### Menjalankan Project
+```bash
+node example.js
+```
+
+## 🏛️ Arsitektur Kode
+
+### 1. **module.js** - Module Wrapper
+Wrapper sederhana untuk module `fs` agar mudah di-import:
+
+```javascript
+import fs from 'fs'
+
+export const mdl = {
+    fs: fs
+}
+```
+
+### 2. **load.js** - Load Data
+Membaca file dan meng-parse data JSON ke array:
+
+```javascript
+export default function load(path) {
+    const dataPath = path
+    const data = mdl.fs.readFileSync(dataPath, 'utf-8')
+    return JSON.parse(data)
+}
+```
+
+### 3. **read.js** - Read Data
+Membaca file dan langsung return data yang sudah di-parse:
+
+```javascript
+export default function read(path) {
+    const data = mdl.fs.readFileSync(dataPath, 'utf-8')
+    return JSON.parse(data)
+}
+```
+
+### 4. **add.js** - Create/Add Data
+Menambahkan data baru ke array dan menyimpannya ke file:
+
+```javascript
+export default function add(path, data) {
+    const database = load(path)
+    database.push(data)
+    const dataPath = mdl.fs.writeFileSync(path, JSON.stringify(database, null, 2))
+    return dataPath
+}
+```
+
+### 5. **find.js** - Read/Search Data
+Mencari data berdasarkan property dan value:
+
+```javascript
+export default function find(path, object, query) {
+    const database = load(path)
+    const cari = database.find((item) => item[object] === query)
+    return cari
+}
+```
+
+### 6. **delete.js** - Delete Data
+Menghapus data berdasarkan property dan value:
+
+```javascript
+export default function deleted(path, object, query) {
+    const database = load(path)
+    const delet = database.filter((item) => item[object] !== query)
+    return mdl.fs.writeFileSync(path, JSON.stringify(delet, null, 2))
+}
+```
+
+### 7. **main.js** - Database Class
+Class utama yang menggabungkan semua operasi:
+
+```javascript
+export default class Database {
+    constructor(path) {
+        this.path = path
+        load(this.path)
+    }
+
+    read() {
+        return read(this.path)
+    }
+
+    add(data) {
+        return add(this.path, data)
+    }
+
+    find(object, query) {
+        return find(this.path, object, query)
+    }
+
+    delete(object, query) {
+        return deleted(this.path, object, query)
+    }
+}
+```
+
+## 💡 Contoh Penggunaan Lengkap
+
+### 1. Inisialisasi Database
+```javascript
+import Database from './main.js'
+
+const db = new Database('./example.json')
+```
+
+### 2. Read - Membaca Semua Data
+```javascript
+const allData = db.read()
+console.log(allData)
+// Output: [{ name: 'johsh', age: 10 }, ...]
+```
+
+### 3. Add - Menambah Data Baru
+```javascript
+const newUser = {
+    name: 'Nasyuwa',
+    age: 17
+}
+db.add(newUser)
+```
+
+### 4. Find - Mencari Data
+```javascript
+const user = db.find('name', 'Budi Santoso')
+console.log(user)
+// Output: { name: 'Budi Santoso', age: 25 }
+```
+
+### 5. Delete - Menghapus Data
+```javascript
+db.delete('name', 'johsh')
+// Menghapus user dengan nama 'johsh' dari database
+```
+
+## 📊 Format Data
+
+Data disimpan dalam format JSON array:
+
+```json
+[
+  {
+    "name": "Nasyuwa",
+    "age": 17
+  }
+  
+]
+```
+
+## 🎯 Yang Saya Pelajari
+
+### Konsep Pemrograman
+✅ Object-Oriented Programming (Class)  
+✅ CRUD Operations (Create, Read, Update, Delete)  
+✅ Modular Code Organization  
+✅ ES Modules (import/export)  
+
+### JavaScript Features
+✅ Array Methods: `.push()`, `.filter()`, `.find()`  
+✅ Arrow Functions: `(item) => item.name`  
+✅ Template Literals dan String Manipulation  
+✅ JSON Parsing dan Stringifying  
+
+### Node.js
+✅ File System Module (`fs`)  
+✅ Synchronous File Operations  
+✅ Path Handling  
+✅ Module System  
+
+## 🔄 Alur Data
+
+```
+User Input
+    ↓
+Database Class (main.js)
+    ↓
+Fungsi Spesifik (add.js, find.js, delete.js, etc.)
+    ↓
+load.js (Parse JSON)
+    ↓
+File System (fs.readFileSync)
+    ↓
+example.json
+```
+
+## ⚠️ Catatan & Pembaruan Ke Depan
+
+### Catatan Saat Ini
+- Menggunakan **synchronous file operations** untuk kesederhanaan pembelajaran
+- Error handling masih minimal
+
+### Improvement Ke Depan
+- [ ] Menggunakan `async/await` untuk operasi file yang lebih efisien
+- [ ] Menambahkan error handling yang lebih robust
+- [ ] Validasi data sebelum menyimpan
+- [ ] Menambahkan fitur update (edit data existing)
+- [ ] Support untuk berbagai format file (CSV, XML, dll)
+- [ ] Database validation schema
+- [ ] Logging system
+
+## 🛠️ Technologies Used
+
+- **Language**: JavaScript (ES6+)
+- **Runtime**: Node.js
+- **Storage**: JSON Files
+- **Module System**: ES Modules
+
+## 📝 Cara Menjalankan Example
+
+File `example.js` mendemonstrasikan semua operasi:
+
+```bash
+# Jalankan example
+node example.js
+
+# Output akan menampilkan:
+# ✅ Database initialized
+# 📖 READ - Membaca semua data
+# ➕ ADD - Menambah data baru
+# 🔍 FIND - Mencari data
+# 🗑️ DELETE - Menghapus data
+```
+
+## 📚 Resources yang Membantu
+
+- [MDN - Array Methods](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)
+- [Node.js File System Documentation](https://nodejs.org/api/fs.html)
+- [ES6 Modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules)
+
+## 👨‍💻 Author
+
+Dibuat sebagai bagian dari perjalanan pembelajaran JavaScript dan Node.js dari nol.
+
+**Nama:** Nasyuwa  
+**Email:** nasyuwa648@gmail.com  
+**GitHub:** [@wa130](https://github.com/wa130)
+
+## 📄 License
+
+Project ini dilisensikan di bawah **MIT License** - lihat file [LICENSE](./LICENSE) untuk detail lengkapnya.
+
+Anda bebas untuk:
+- ✅ Menggunakan project ini untuk tujuan komersial maupun personal
+- ✅ Memodifikasi dan mengubah kode sesuai kebutuhan
+- ✅ Mendistribusikan ulang project ini
+- ✅ Menggunakan project ini sebagai basis untuk project lain
+
+Dengan syarat:
+- 📋 Menyertakan lisensi dan copyright notice dalam setiap distribusi
+
+---
+
+**Happy Learning & Coding!** 🚀✨
+
+*Jika Anda memiliki pertanyaan atau saran untuk improvement, feel free untuk membuat issues atau pull requests!*

package/add.js

@@ -0,0 +1,10 @@
+import { mdl } from  './module.js'
+import load from './load.js'
+
+export default function add(path, data) {
+    const database = load(path)
+    database.push(data)
+    const dataPath = mdl.fs.writeFileSync(path, JSON.stringify(database, null, 2))
+    return dataPath
+}
+

package/delete.js

@@ -0,0 +1,8 @@
+import { mdl } from  './module.js'
+import load from './load.js'
+
+export default function deleted(path, object, query) {
+    const database = load(path)
+    const delet = database.filter((item) => item[object] !== query)
+    return mdl.fs.writeFileSync(path, JSON.stringify(delet, null, 2))
+}

package/example.js

@@ -0,0 +1,76 @@
+import Database from './main.js'
+
+
+// ============================================
+// INISIALISASI DATABASE
+// ============================================
+const db = new Database('./example.json')
+console.log('✅ Database initialized at example.json\n')
+
+// ============================================
+// 1. READ - Membaca semua data
+// ============================================
+console.log('📖 READ - Membaca semua data:')
+const allData = db.read()
+console.log(JSON.stringify(allData, null, 2))
+console.log('')
+
+// ============================================
+// 2. ADD - Menambah data baru
+// ============================================
+console.log('➕ ADD - Menambah data baru:')
+const newUser = {
+    name: 'Nasyuwa',
+    age: 17
+}
+console.log('Data yang ditambahkan:', JSON.stringify(newUser, null, 2))
+db.add(newUser)
+console.log('✓ Data berhasil ditambahkan\n')
+
+// Read lagi untuk melihat hasil penambahan
+console.log('📖 Data setelah penambahan:')
+const dataAfterAdd = db.read()
+console.log(JSON.stringify(dataAfterAdd, null, 2))
+console.log('')
+
+// ============================================
+// 3. FIND - Mencari data berdasarkan kriteria
+// ============================================
+console.log('🔍 FIND - Mencari data berdasarkan kriteria:')
+console.log('Mencari user dengan nama = "johsh":')
+const foundUser = db.find('name', 'johsh')
+console.log(JSON.stringify(foundUser, null, 2))
+console.log('')
+
+console.log('Mencari user dengan nama = "Budi Santoso":')
+const foundUser2 = db.find('name', 'Budi Santoso')
+console.log(JSON.stringify(foundUser2, null, 2))
+console.log('')
+
+// ============================================
+// 4. DELETE - Menghapus data berdasarkan kriteria
+// ============================================
+console.log('🗑️ DELETE - Menghapus data berdasarkan kriteria:')
+console.log('Menghapus user dengan nama = "johsh":')
+db.delete('name', 'johsh')
+console.log('✓ Data berhasil dihapus\n')
+
+// Read lagi untuk melihat hasil penghapusan
+console.log('📖 Data setelah penghapusan:')
+const dataAfterDelete = db.read()
+console.log(JSON.stringify(dataAfterDelete, null, 2))
+console.log('')
+
+// ============================================
+// KESIMPULAN
+// ============================================
+console.log('============================================')
+console.log('✅ Semua operasi CRUD berhasil dijalankan!')
+console.log('============================================')
+console.log('\nRingkasan operasi:')
+console.log('• READ   - Membaca semua data dari file')
+console.log('• ADD    - Menambah data baru ke file')
+console.log('• FIND   - Mencari data berdasarkan property & value')
+console.log('• DELETE - Menghapus data berdasarkan property & value')
+
+

package/find.js

@@ -0,0 +1,8 @@
+import load from './load.js'
+
+export default function find(path, object, query) {
+    const database = load(path)
+    const cari = database.find((item) => item[object] === query)
+
+    return cari
+}

package/load.js

@@ -0,0 +1,10 @@
+import { mdl } from './module.js'
+
+export default function load(path) {
+    const dataPath = path
+
+    const data = mdl.fs.readFileSync(dataPath, 'utf-8')
+    const database = JSON.parse(data)
+
+    return database
+}

package/main.js

@@ -0,0 +1,30 @@
+import load from './load.js'
+import add from './add.js'
+import find from './find.js'
+import deleted from './delete.js'
+import read from './read.js'
+
+
+export default class Database {
+    constructor(path) {
+        this.path = path
+        load(this.path)
+    }
+
+    read() {
+        return read(this.path)
+    }
+
+    add(data) {
+        return add(this.path, data)
+    }
+
+    find(object, query) {
+        return find(this.path, object, query)
+    }
+
+    delete(object, query) {
+        return deleted(this.path, object, query)
+    }
+}
+

package/module.js

@@ -0,0 +1,5 @@
+import fs from 'fs'
+
+export const mdl = {
+    fs: fs
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "json-db-engine",
+  "version": "1.0.0",
+  "description": "Database Management System sederhana menggunakan JSON dan Node.js File System",
+  "main": "main.js",
+  "type": "module",
+  "scripts": {
+    "start": "node example.js",
+    "dev": "node example.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "database",
+    "json",
+    "crud",
+    "file-system",
+    "node.js",
+    "javascript",
+    "learning"
+  ],
+  "author": {
+    "name": "Nasyuwa",
+    "email": "nasyuwa648@gmail.com",
+    "url": "https://github.com/wa130"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wa130/json-db-enginee.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wa130/json-db-enginee/issues"
+  },
+  "homepage": "https://github.com/wa130/json-db-enginee#readme",
+  "license": "MIT",
+  "engines": {
+    "node": ">=12.0.0"
+  },
+  "dependencies": {}
+}

package/read.js

@@ -0,0 +1,8 @@
+import { mdl } from './module.js'
+
+export default function read(path) {
+    const dataPath = path
+    const data = mdl.fs.readFileSync(dataPath, 'utf-8')
+
+    return JSON.parse(data)
+}