Nxdom Framework

Nusantara eXtreme Development Object Model — dokumentasi resmi

NexaFirebase (React)

Halaman ini merangkum pola penggunaan NexaFirebase untuk operasi data realtime, sinkronisasi offline, autentikasi dasar, dan utilitas debugging dalam alur aplikasi React.

API utama yang diekspor

  • NexaFirebase(table): inisialisasi cepat (direkomendasikan).
  • nexaFirebase(table): buat instance CRUD berbasis tabel.
  • firebaseData(table): alias factory tambahan.
  • NexaFirestore: class inti untuk operasi lanjutan.
  • clearNexaFirebaseCache() / getNexaFirebaseCacheInfo(): utilitas cache instance.

Quick start

import { NexaFirebase } from "NexaJS"; const usersCRUD = await NexaFirebase("users"); const ping = await usersCRUD.testConnection();

CRUD dasar

// Create await usersCRUD.add({ user1: { name: "John", email: "john@example.com", active: true }, }); // Read const one = await usersCRUD.get("user1"); const all = await usersCRUD.getAll(); // Update await usersCRUD.history({ user1: { name: "John Updated", email: "john@example.com", active: true }, }); // Delete await usersCRUD.del("user1");

Offline & local cache

// Simpan dengan fallback offline await usersCRUD.addOffline({ user_local: { name: "Offline User", email: "offline@example.com" }, }); // Ambil data (Firebase -> fallback local) const user = await usersCRUD.getOffline("user_local"); // Sinkronisasi kembali saat online const sync = await usersCRUD.syncWithFirebase();

Auth ringkas

const result = await usersCRUD.createAccount( "user@example.com", "password123", { displayName: "Nexa User" } );

Platform info & debugging

  • getPlatformInfo() untuk deteksi Android/iOS/Web saat runtime.
  • testConnection() dan testWritePermission() untuk validasi koneksi.
  • getNexaFirebaseCacheInfo() untuk melihat status cache instance.
  • clearNexaFirebaseCache() untuk reset cache saat troubleshooting.

Praktik disarankan

  • Mulai dari NexaFirebase() agar konfigurasi otomatis konsisten.
  • Gunakan satu tabel per domain data (mis. users, orders).
  • Aktifkan pola offline untuk fitur kritikal di mobile.
  • Uji testConnection() di startup jika aplikasi sensitif jaringan.