UsemiDB 🚀

UsemiDB, Node.js projeleri için hafif, yüksek performanslı ve JSON tabanlı bir key-value database sistemidir.

v0.2.0 AES-256 Veri Şifreleme, Şema Doğrulama ve Gelişmiş Filtreleme!

⚡ Özellikler

• 🔐 Askeri Düzey Şifreleme (YENİ): Veritabanı dosyanızı AES-256 ile şifreleyin, dışarıdan okunmasını engelleyin.
• 🌉 Göç Köprüsü: Quick.db veya standart JSON dosyalarından tek komutla verilerinizi UsemiDB'ye aktarın.
• 🛡️ Schema: Verilerinizi güvenceye alın, yanlış veri tipi girildiğinde veritabanının bozulmasını önleyin.
• 🎛️ Gelişmiş Filtreleme: $gt, $lt, $in, $includes gibi MongoDB tarzı operatörlerle detaylı veri sorgulama.
• 🎯 Dot Notation: user.settings.theme gibi iç içe verilere doğrudan erişim ve güncelleme.
• 🛡️ Snapshot & Restore: İstediğiniz an veritabanının yedeğini alın (backup) ve geri dönün (restore).
• 🔎 Gelişmiş Arama: find ve findOne ile obje özelliklerine göre hızlıca veri bulun.
• ✖️➗ Matematik Seti: add, subtract, multiply, divide işlemlerini nokta notasyonu ile yapın.
• ✨ Akıllı Listeler: pushUnique ile tekrarsız ekleme ve pull ile listeden silme.
• 🎲 Random: Veritabanından rastgele veri çekme.
• ⚡ Performans: writeDelay (Debounce) sistemi ile diski yormadan toplu yazma.
• ⏳ TTL Desteği: Verilere ömür biçin, süresi dolunca otomatik silinsin.
• 📁 Collections: Verilerinizi namespace (koleksiyon) bazlı gruplandırın.

🔹 Kullanım Örnekleri

1. Kurulum & Ayarlar

const UsemiDB = require("usemidb");

const db = new UsemiDB({
  filePath: "./usemidb/usemidb.json", // Veri dosyası
  backupPath: "./usemidb/backups", // Yedek klasörü
  writeDelay: 100,                  // Performans için yazma gecikmesi (ms)
  autoCleanInterval: 60000          // TTL kontrol aralığı (ms)
});

2. 🎯 Dot Notation (Nokta Notasyonu) - YENİ!

// İç içe veri kaydetme
await db.set("user_1.settings.theme", "dark");
await db.set("user_1.settings.notifications", true);

// Veriyi okuma
const theme = db.get("user_1.settings.theme");
console.log(theme); // "dark"

// Tüm objeyi de çekebilirsiniz
console.log(db.get("user_1"));
// { settings: { theme: "dark", notifications: true } }

3. ✖️ Matematiksel İşlemler

await db.set("user_1.stats.xp", 100);

// Ekleme & Çıkarma
await db.add("user_1.stats.xp", 50);       // 150
await db.subtract("user_1.stats.xp", 10);  // 140

// Çarpma & Bölme
await db.multiply("user_1.stats.xp", 2);   // 280
await db.divide("user_1.stats.xp", 2);     // 140

4. ✨ Akıllı Liste (Array) Yönetimi

// Normal Ekleme
await db.push("etiketler", "nodejs");

// ⭐️ Unique Push (Tekrarsız Ekleme)
// Eğer "nodejs" listede varsa tekrar eklemez!
await db.pushUnique("etiketler", "nodejs");

// İç içe listelere erişim
await db.push("user_1.inventory", "sword");

// Listeden Silme (Pull)
await db.pull("user_1.inventory", "sword");

5. 🛡️ Yedekleme & Geri Yükleme (Snapshot)

// Kritik bir işlemden önce yedek al
await db.backup("guvenli-nokta-v1");
console.log("Yedek alındı!");

// ...Veriler bozulursa veya silinirse...

// Yedeği geri yükle
await db.restore("guvenli-nokta-v1");
console.log("Veriler kurtarıldı.");

6. 🔎 Arama & Rastgele Veri

// Obje özelliklerine göre arama
const admins = db.find({ role: "admin" });

// İsme göre tek kişi bul
const user = db.findOne({ username: "Lorely" });

// Rastgele veri çek (Çekilişler için)
const winner = await db.random();

7. 🗂️ Koleksiyonlar (Namespaces)

const economy = db.collection("economy");

// Sadece 'economy' koleksiyonuna yazar
await economy.set("user_1", 500);

// Koleksiyon içinde de nokta notasyonu çalışır
await economy.add("user_1", 50);

📡 Event Sistemi

db.on("set", (key, value) => {
  console.log(`[KAYIT] ${key} = ${JSON.stringify(value)}`);
});

db.on("expired", (key) => {
  console.log(`[TTL] ${key} süresi doldu ve silindi.`);
});

8. 🎛️ Gelişmiş Filtreleme (MongoDB Operatörleri)

Arama yaparken sadece birebir eşleşme değil; büyüktür, küçüktür, içerir gibi detaylı şartlar kullanabilirsiniz. Nokta notasyonu ile tam uyumludur!

// Leveli 50'den BÜYÜK olanları getir ($gt)
const proPlayers = db.find({ "stats.level": { $gt: 50 } });

// İsminde "Ahmet" GEÇENLERİ getir ($includes)
const ahmetler = db.find({ "username": { $includes: "Ahmet" } });

// Şununla BAŞLAYANLARI getir ($startsWith)
const botKullanicilari = db.find({ "username": { $startsWith: "Bot_" } });

// Rolü admin VEYA mod olanları getir ($in)
const yetkililer = db.find({ "role": { $in: ["admin", "mod"] } });

// Bakiyesi 1000 ile 5000 arasında olanları getir ($gt, $lt)
const ortaSınıf = db.find({ "bakiye": { $gt: 1000, $lt: 5000 } });

9. 🛡️ Schema Validation (Veri Doğrulama Kalkanı)

Veritabanınıza yanlış veri girilmesini önleyin. Eğer kural dışı bir veri girilirse UsemiDB anında işlemi durdurup sizi uyarır.

"bakiye" anahtarı HER ZAMAN sayı (number) olmak zorundadır!
db.schema.define("bakiye", "number");

"users" ile başlayan her şey bu şemaya uymalıdır!
db.schema.define("users", {
    username: "string",
    age: "number",
    isBanned: "boolean"
});

// Başarılı işlem:
await db.set("bakiye", 1500); 

// BAŞARISIZ İŞLEM (Hata Fırlatır ve Kaydetmez!):
await db.set("bakiye", "bin beş yüz"); 
// ❌ HATA: [UsemiDB Güvenlik Kalkanı] 'bakiye' verisi 'number' tipinde olmalıdır!

await db.set("users:1", { username: "Lorely", age: "Yirmi" });
// ❌ HATA: [UsemiDB Güvenlik Kalkanı] 'users:1.age' verisi 'number' tipinde olmalıdır!

10. 🌉 İmport Özelliği (Migration from Quick.db / JSON)

Verilerinizi kaybetmeden UsemiDB'ye geçin! UsemiDB, Quick.db'nin formatını ve standart JSON formatını otomatik tanır.

// Seçenek 1: Başka bir JSON dosyasından aktar
await db.importFrom("./eski_veritabaniniz.json");

// Seçenek 2: Quick.db'den tüm verileri aktar
const quickdb = require("quick.db");
await db.importFrom(quickdb.all(), { clearFirst: true }); 

console.log("Göç tamamlandı! Tüm verileriniz artık UsemiDB formatında.");

11. 🔐 Encryption (Veri Şifreleme)

UsemiDB'yi başlatırken bir encryptionKey (Şifreleme Anahtarı) eklerseniz, JSON dosyanız diske düz metin olarak değil, AES-256 ile şifrelenmiş anlamsız karakterler olarak kaydedilir. Verileriniz %100 güvende kalır.

const UsemiDB = require("usemidb");

const db = new UsemiDB({
  filePath: "./usemidb/usemidb.json", 
  encryptionKey: "benim-cok-gizli-sifrem-123", // 🔐 Bunu eklemek yeterli
});

// Artık diske yazılan hiçbir veri dışarıdan (Not Defteri vb. ile) okunamaz!
await db.set("gizli_token", "ABC-123-XYZ");

💻 Kurulum

npm install usemidb

🔗 Linkler

📦 NPM Sayfası

UsemiDB NPM Paketi

🐈 Github Sayfası

UsemiDB Github