Cord-DB-JS 🚀

Cord-DB-JS, Firebase Realtime Database'i Node.js projelerinizde en basit ve hızlı şekilde kullanmanızı sağlayan hafif bir Firebase Admin SDK sarmalayıcısıdır. Artık dosya yolu karmaşası olmadan, otomatik dizin çözümleme desteğiyle!

📦 Kurulum

npm install cord-db-js

⚙️ Yapılandırma

Cord-DB-JS'nin çalışması için iki ana şeye ihtiyacınız vardır: Database URL ve serviceAccountKey.json.

serviceAccountKey.json Nedir?

Bu dosya, uygulamanızın Firebase veritabanınıza güvenli bir şekilde erişmesini sağlayan özel anahtar dosyasıdır.

Nasıl Alınır?

1. Firebase Konsolu'na gidin.
2. Project Settings > Service Accounts sekmesine girin.
3. Generate New Private Key butonuna basarak dosyayı indirin.
4. Dosyayı projenizin ana dizinine koyun ve adını serviceAccountKey.json yapın.

⚠️ GÜVENLİK: serviceAccountKey.json dosyanızı asla GitHub'da paylaşmayın! .gitignore dosyanıza eklemeyi unutmayın.

🚀 Kullanım (ESM)

Cord-DB-JS, modern projeler için tam ESM desteği sunar.

1. tools.js (Tanımlama)

Artık path veya __dirname ile uğraşmanıza gerek yok. Sadece dosya adını vermeniz yeterli!

import { CordDB } from "cord-db-js";

const db = new CordDB({
  databaseURL: "https://PROJE_ID-default-rtdb.firebaseio.com/",
  serviceAccount: "./serviceAccountKey.json" // Otomatik olarak tools.js'nin yanına bakar
});

export default db;

2. app.js (Kullanım)

import db from "./tools.js";

// Veri Kaydetme
await db.set("kullanici/1", { isim: "Apo", puan: 100 });

// Veri Çekme
const veri = await db.get("kullanici/1");
console.log(veri); // { isim: "Apo", puan: 100 }

🛠 Metotlar

| Metot | Açıklama | | --- | --- | | set(key, value) | Belirtilen anahtara veri yazar. | | get(key) | Belirtilen anahtardaki veriyi çeker. | | fetch(key) | get metodu ile aynıdır. | | update(key, obj) | Mevcut veriyi silmeden günceller. | | add(key, n) | Sayısal değeri n kadar artırır (Transaction). | | subtract(key, n) | Sayısal değeri n kadar azaltır (Transaction). | | push(key, value) | Belirtilen yola benzersiz bir ID ile veri ekler. | | delete(key) | Belirtilen anahtardaki veriyi siler. | | has(key) | Verinin olup olmadığını kontrol eder (boolean). | | all() | Tüm veritabanını obje olarak döndürür. | | clear() | Tüm veritabanını temizler (Dikkatli kullanın!). |

📄 Lisans

MIT © abdulrahmanemin