📦 ByBugAuth & ByBugDatabase Documentation / Kullanım Dökümanı #

A full-featured authentication and realtime database management system for Flutter, backed by a blazing-fast Python-based API stack.

🌐 Language / Dil Seçimi #

• 🇹🇷 Türkçe Dökümantasyon
• 🇺🇸 English Documentation

🇹🇷 Türkçe Dökümantasyon #

🚀 Genel Bilgilendirme #

ByBugDB sistemi; Redis, FastAPI, WebSocket ve SQLite ile desteklenen, mikro saniye düzeyinde hızlı işlem yapılabilen bir backend sistemine bağlı çalışır. Bu Flutter kütüphanesi, yalnızca frontend arayüzüdür ve çalışabilmesi için Python sunucusuna bağlanmak zorundadır.

Python scripti olmadan bu sistem çalışmaz.
Yardım ve kurulum için: t.me/JeaFrid

🔐 ByBugAuth — Kimlik Yönetimi #

ByBugAuth, kullanıcı kayıt, giriş, oturum yönetimi, UID üretimi ve hesap silme işlemlerini sağlar.

✅ Kullanıcı Kaydı

final result = await ByBugAuth.register("ali@mail.com", "123456");

🔐 Giriş Yapma

final login = await ByBugAuth.login("ali@mail.com", "123456");

🆔 UID Üretimi

final uid = ByBugAuth.generateUID();

👤 Oturum Bilgisi Sorgulama

if (await ByBugAuth.isSignedIn()) print("Oturum açık");

📝 Profil Güncelleme

await ByBugAuth.updateProfile({"theme": "dark", "language": "tr"});

❌ Hesap Silme

await ByBugAuth.deleteAccount();

🧠 ByBugDatabase — Veri Tabanı İşlemleri #

ByBugDatabase; verileri bucket (koleksiyon), tag (benzersiz anahtar) ve value (JSON veri) olarak işler. WebSocket üzerinden gerçek zamanlı dinleme destekler.

➕ Veri Ekleme

await ByBugDatabase.add("users", "user123", {"name": "Ali", "email": "ali@mail.com"});

🔍 Veri Çekme

final result = await ByBugDatabase.get("users", "user123");

❌ Veri Silme

await ByBugDatabase.remove("users", "user123");

📡 Gerçek Zamanlı Dinleme

await ByBugDatabase.listen("users", (data) {
  print("Değişiklik var: $data");
});

🔁 Toplu Veri Ekleme

await ByBugDatabase.addAll([
  ["users", "userA", {"name": "Ayşe"}],
  ["users", "userB", {"name": "Mehmet"}]
]);

🧹 Bucket Temizleme

await ByBugDatabase.clear("users");

🇺🇸 English Documentation #

🚀 Overview #

ByBugDB is a lightning-fast backend system built with Redis, FastAPI, WebSocket, and SQLite. This Flutter library is a client only; it requires a connected Python API server to function.

This system will not work without the Python script.
For assistance: t.me/JeaFrid

🔐 ByBugAuth — Authentication System #

ByBugAuth handles account registration, login, session control, and user identity.

✅ Register User

final result = await ByBugAuth.register("ali@mail.com", "123456");

🔐 Login

final login = await ByBugAuth.login("ali@mail.com", "123456");

🆔 Generate UID

final uid = ByBugAuth.generateUID();

👤 Check Session

if (await ByBugAuth.isSignedIn()) print("User signed in");

📝 Update Profile

await ByBugAuth.updateProfile({"theme": "dark", "language": "en"});

❌ Delete Account

await ByBugAuth.deleteAccount();

🧠 ByBugDatabase — Realtime Data Management #

ByBugDatabase uses a bucket-tag-value model to store data and supports realtime data subscriptions via WebSocket.

➕ Add Data

await ByBugDatabase.add("users", "user123", {"name": "Ali", "email": "ali@mail.com"});

🔍 Get Data

final result = await ByBugDatabase.get("users", "user123");

❌ Delete Data

await ByBugDatabase.remove("users", "user123");

📡 Realtime Listener

await ByBugDatabase.listen("users", (data) {
  print("Change detected: $data");
});

🔁 Bulk Insert

await ByBugDatabase.addAll([
  ["users", "userA", {"name": "Alice"}],
  ["users", "userB", {"name": "Bob"}]
]);

🧹 Clear Bucket

await ByBugDatabase.clear("users");

⚠️ Important Notice #

Both ByBugAuth and ByBugDatabase require a Python server. You cannot use them independently.
Flutter only acts as a client — Python provides the real-time database and auth functionality.

🧠 Tech Details #

• Bucket: Collection name (e.g., "users")
• Tag: Unique record ID (e.g., "user123")
• Value: JSON structure { "field": "value" }
• WS Port: Uses ws://host/ws?token=...
• HTTP API: Uses POST with JSON payloads

📬 Contact & Support #

For backend script, updates, or commercial licensing:
👉 t.me/JeaFrid