Morsel Ultra Database

Node.js projeleri için hızlı, kolay, JSON & SQLite destekli, TypeScript uyumlu gelişmiş bir veritabanı kütüphanesi.

morsel-ultra.db hem JSON dosyalarını hem SQLite veritabanını tek bir arayüzle kullanmanı sağlar.

🚀 Özellikler

• ✔️ JSON ve SQLite desteği
• ✔️ Kolay kurulum
• ✔️ Map tabanlı cache sistemi
• ✔️ Otomatik dosya oluşturma
• ✔️ TypeScript desteği
• ✔️ Basit & hızlı kullanım
• ✔️ Event destekli (set, delete vs.)

📦 Kurulum

npm install morsel-ultra.db

yada

yarn add morsel-ultra.db

🛠️ Başlangıç – Hızlı Kullanım

const Database = require("morsel-ultra.db");

const db = new Database({
    backend: "json", // json | sqlite
    file: "morsel-ultra.db" // sqlite için .db dosyası, json için .json
});

// Değer kaydet
await db.set("kullanici.para", 1500);

// Değer çek
const para = await db.get("kullanici.para");
console.log(para); // 1500

// Veri sil
await db.delete("kullanici.para");

📁 Yapılandırma Seçenekleri

new Database({
    backend: "json" | "sqlite",
    file: "morsel-ultra.db",
    autosave: true,
    indent: 2
});

JSON modu için:

• Dosya otomatik oluşturulur
• Hızlı okuma / yazma
• Küçük projeler için ideal

SQLite modu için:

• Büyük projeler için daha stabil
• Daha hızlı sorgular

🔥 Gelişmiş Kullanım

🔹 Nesne Kaydetme

await db.set("ayarlar", {
    prefix: "!",
    renk: "#8257e6"
});

🔹 Sadece Bir Alanı Güncelleme

await db.set("ayarlar.prefix", "?");

🔹 Tüm Veritabanını Çekme

const data = await db.all();
console.log(data);

🔹 Silme

await db.delete("ayarlar.prefix");

📡 Event Sistemi

db.on("set", (key, value) => {
    console.log(`Yeni veri: ${key} =`, value);
});

db.on("delete", (key) => {
    console.log(`Silindi: ${key}`);
});

📘 TypeScript Kullanımı

import Database from "morsel-ultra.db";

const db = new Database({ backend: "sqlite", file: "morsel-ultra.db" });

await db.set("user.balance", 100);
const x = await db.get<number>("user.balance");

⚠️ Key Notasyonu

• Nesne yolları . ile ayrılır
• kullanici.bilgi.yas

Örnek JSON:

{
  "kullanici": {
    "bilgi": {
      "yas": 16
    }
  }
}

📄 Lisans

MIT License

🙌 Katkıda Bulunma

Pull Request gönderebilir veya Issue açabilirsin.

⭐ Destek Ol

Beğendiysen bir ⭐ bırakmayı unutma!