nexabase-console 1.0.0 → 1.0.2

package/README.md

@@ -1,4 +1,4 @@
-# NexaBase JavaScript SDK (`nexabase`)
+# NexaBase JavaScript SDK (`nexabase-console`)
 
 SDK Client Resmi untuk **NexaBase**: Platform sinkronisasi database modern yang menyatukan fungsionalitas Firestore NoSQL, Real-Time Database, File Storage, dan Edge Authentication dengan dukungan **Offline-First (IndexedDB)** serta **Passwordless OTP**.
 
@@ -19,45 +19,9 @@ SDK Client Resmi untuk **NexaBase**: Platform sinkronisasi database modern yang
 Instal package melalui npm atau yarn:
 
 ```bash
-npm install nexabase
+npm install nexabase-console
 # atau
-yarn add nexabase
-```
-
----
-
-## ⚡ Panduan Rilis (Publishing)
-
-Jika Anda ingin mengunggah SDK ini ke repositori **GitHub** Anda sendiri atau merilisnya ke registry **NPM**, ikuti langkah mudah berikut:
-
-### 1. Inisialisasi Repositori Git & GitHub
-```bash
-# Masuk ke direktori SDK
-cd nexabase-sdk
-
-# Inisialisasi Git
-git init
-git add .
-git commit -m "Inisialisasi rilis perdana NexaBase SDK v1.0.0"
-
-# Tambahkan remote repositori GitHub Anda
-git remote add origin https://github.com/USERNAME/REPOS_NAME.git
-git branch -M main
-git push -u origin main
-```
-
-### 2. Publikasi ke NPM Registry
-Pastikan Anda sudah memiliki akun di [npmjs.com](https://www.npmjs.com/).
-
-```bash
-# Login ke akun NPM Anda melalui terminal
-npm login
-
-# Jalankan build compiler TypeScript
-npm run build
-
-# Publikasikan ke registry NPM secara publik
-npm publish --access public
+yarn add nexabase-console
 ```
 
 ---
@@ -67,12 +31,11 @@ npm publish --access public
 ### 1. Inisialisasi Aplikasi
 
 ```javascript
-import { initializeApp, getFirestore } from 'nexabase';
+import { initializeApp, getFirestore } from 'nexabase-console';
 
 const app = initializeApp({
   projectId: 'PROYEK_NEXABASE_ID_ANDA',
-  apiKey: 'NEXABASE_API_KEY_ANDA', // Opsional, tergantung aturan keamanan
-  endpoint: 'https://nexabase-server.yourdomain.com' // Alamat URL server backend
+  apiKey: 'NEXABASE_API_KEY_ANDA' // Opsional, default endpoint mengarah ke https://db.nexabase.id
 });
 
 const db = getFirestore(app);
@@ -84,7 +47,7 @@ const db = getFirestore(app);
 
 #### Menulis Data Baru (Set Doc)
 ```javascript
-import { doc, setDoc } from 'nexabase';
+import { doc, setDoc } from 'nexabase-console';
 
 const main = async () => {
   const profileRef = doc(db, 'users', 'budi_santoso');
@@ -103,7 +66,7 @@ main();
 
 #### Memperbarui Sebagian Data (Update Doc)
 ```javascript
-import { doc, updateDoc } from 'nexabase';
+import { doc, updateDoc } from 'nexabase-console';
 
 const editData = async () => {
   const profileRef = doc(db, 'users', 'budi_santoso');
@@ -115,7 +78,7 @@ const editData = async () => {
 
 #### Membaca Satu Dokumen (Get Doc)
 ```javascript
-import { doc, getDoc } from 'nexabase';
+import { doc, getDoc } from 'nexabase-console';
 
 const readData = async () => {
   const profileRef = doc(db, 'users', 'budi_santoso');
@@ -131,7 +94,7 @@ const readData = async () => {
 
 #### Mendengarkan Perubahan Data secara Real-Time (onSnapshot)
 ```javascript
-import { doc, onSnapshot } from 'nexabase';
+import { doc, onSnapshot } from 'nexabase-console';
 
 const listenLive = () => {
   const docRef = doc(db, 'chats', 'global_room');
@@ -148,7 +111,7 @@ const listenLive = () => {
 
 #### Menggunakan Atomic Write Batch
 ```javascript
-import { doc, writeBatch } from 'nexabase';
+import { doc, writeBatch } from 'nexabase-console';
 
 const executeBatch = async () => {
   const batch = writeBatch(db);

package/dist/index.d.ts

@@ -51,6 +51,7 @@ export interface QuerySnapshot {
     forEach: (callback: (doc: QueryDocumentSnapshot) => void) => void;
     empty: boolean;
     size: number;
+    docChanges?: () => any[];
 }
 export interface DatabaseReference {
     get: () => Promise<any>;
@@ -134,6 +135,6 @@ export declare const getDoc: (docRef: DocumentReference) => Promise<DocumentSnap
 export declare const setDoc: (docRef: DocumentReference, data: any) => Promise<any>;
 export declare const updateDoc: (docRef: DocumentReference, data: any) => Promise<any>;
 export declare const deleteDoc: (docRef: DocumentReference) => Promise<any>;
-export declare const onSnapshot: (ref: CollectionReference | DocumentReference, callback: (snapshot: any) => void) => (() => void);
+export declare const onSnapshot: (ref: CollectionReference | DocumentReference | Query, callback: (snapshot: any) => void) => (() => void);
 export declare const writeBatch: (db: NexaApp) => WriteBatch;
 export {};

package/dist/index.js

@@ -29,7 +29,7 @@ class NexaApp {
                 this.token = savedToken;
             }
         }
-        this.endpoint = config.endpoint || (typeof window !== 'undefined' ? window.location.origin : '');
+        this.endpoint = config.endpoint || 'https://db.nexabase.id';
         this.client = axios_1.default.create({
             baseURL: this.endpoint,
             headers: {
@@ -321,8 +321,10 @@ class NexaApp {
             else if (change.type === 'document_deleted') {
                 await this._deleteCache(change.docPath);
             }
-            Object.keys(this._snapshotCallbacks).forEach((pathKey) => {
-                const cb = this._snapshotCallbacks[pathKey];
+            Object.keys(this._snapshotCallbacks).forEach((key) => {
+                const cb = this._snapshotCallbacks[key];
+                const parts = key.split('_');
+                const pathKey = parts.slice(2).join('_');
                 if (pathKey === change.docPath || change.docPath.startsWith(pathKey + '/')) {
                     cb(change);
                 }
@@ -400,10 +402,14 @@ const getDocs = async (queryOrCollection) => {
             docs: docsArray,
             forEach: (cb) => docsArray.forEach(cb),
             empty: docsArray.length === 0,
-            size: docsArray.length
+            size: docsArray.length,
+            docChanges: () => docsArray.map(doc => ({ type: 'added', doc }))
         };
     }
     catch (err) {
+        if (err && err.response) {
+            throw err;
+        }
         const results = [];
         Object.keys(db._firestoreCache).forEach((p) => {
             if (p.startsWith(collectionPath + '/')) {
@@ -432,6 +438,15 @@ const getDocs = async (queryOrCollection) => {
                         return val <= c.value;
                     if (c.opStr === '!=')
                         return val !== c.value;
+                    if (c.opStr === 'in')
+                        return Array.isArray(c.value) && c.value.includes(val);
+                    if (c.opStr === 'not-in')
+                        return Array.isArray(c.value) && !c.value.includes(val);
+                    if (c.opStr === 'array-contains')
+                        return Array.isArray(val) && val.includes(c.value);
+                    if (c.opStr === 'array-contains-any') {
+                        return Array.isArray(val) && Array.isArray(c.value) && val.some((v) => c.value.includes(v));
+                    }
                     return true;
                 });
             }
@@ -440,7 +455,8 @@ const getDocs = async (queryOrCollection) => {
             docs: filtered,
             forEach: (cb) => filtered.forEach(cb),
             empty: filtered.length === 0,
-            size: filtered.length
+            size: filtered.length,
+            docChanges: () => filtered.map(doc => ({ type: 'added', doc }))
         };
     }
 };
@@ -456,6 +472,9 @@ const getDoc = async (docRef) => {
         return { exists: () => !!data, data: () => data };
     }
     catch (err) {
+        if (err && err.response) {
+            throw err;
+        }
         const data = db._firestoreCache[docRef.path];
         return { exists: () => !!data, data: () => data || null };
     }
@@ -467,8 +486,10 @@ const setDoc = async (docRef, data) => {
         await db._initPromise;
     await db._setCache(docRef.path, data);
     // Trigger snapshot listeners
-    Object.keys(db._snapshotCallbacks).forEach((pathKey) => {
-        const cb = db._snapshotCallbacks[pathKey];
+    Object.keys(db._snapshotCallbacks).forEach((key) => {
+        const cb = db._snapshotCallbacks[key];
+        const parts = key.split('_');
+        const pathKey = parts.slice(2).join('_');
         if (pathKey === docRef.path || docRef.path.startsWith(pathKey + '/')) {
             cb({ type: 'document_written', docPath: docRef.path, data });
         }
@@ -520,8 +541,10 @@ const deleteDoc = async (docRef) => {
         await db._initPromise;
     await db._deleteCache(docRef.path);
     // Trigger snapshot listeners
-    Object.keys(db._snapshotCallbacks).forEach((pathKey) => {
-        const cb = db._snapshotCallbacks[pathKey];
+    Object.keys(db._snapshotCallbacks).forEach((key) => {
+        const cb = db._snapshotCallbacks[key];
+        const parts = key.split('_');
+        const pathKey = parts.slice(2).join('_');
         if (pathKey === docRef.path || docRef.path.startsWith(pathKey + '/')) {
             cb({ type: 'document_deleted', docPath: docRef.path });
         }
@@ -551,7 +574,7 @@ const onSnapshot = (ref, callback) => {
         db._ensureFirestoreSSE();
         const pathKey = ref.path;
         const triggerCallback = async () => {
-            if (ref.type === 'collection') {
+            if (ref.type === 'collection' || ref.type === 'query') {
                 const docs = await (0, exports.getDocs)(ref);
                 callback(docs);
             }
@@ -600,8 +623,10 @@ const writeBatch = (db) => {
                 if (op.type === 'set' || op.type === 'update') {
                     const newData = { ...db._firestoreCache[op.path], ...op.data };
                     await db._setCache(op.path, newData);
-                    Object.keys(db._snapshotCallbacks).forEach((pathKey) => {
-                        const cb = db._snapshotCallbacks[pathKey];
+                    Object.keys(db._snapshotCallbacks).forEach((key) => {
+                        const cb = db._snapshotCallbacks[key];
+                        const parts = key.split('_');
+                        const pathKey = parts.slice(2).join('_');
                         if (pathKey === op.path || op.path.startsWith(pathKey + '/')) {
                             cb({ type: 'document_written', docPath: op.path, data: db._firestoreCache[op.path] });
                         }
@@ -609,8 +634,10 @@ const writeBatch = (db) => {
                 }
                 else if (op.type === 'delete') {
                     await db._deleteCache(op.path);
-                    Object.keys(db._snapshotCallbacks).forEach((pathKey) => {
-                        const cb = db._snapshotCallbacks[pathKey];
+                    Object.keys(db._snapshotCallbacks).forEach((key) => {
+                        const cb = db._snapshotCallbacks[key];
+                        const parts = key.split('_');
+                        const pathKey = parts.slice(2).join('_');
                         if (pathKey === op.path || op.path.startsWith(pathKey + '/')) {
                             cb({ type: 'document_deleted', docPath: op.path });
                         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexabase-console",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "SDK Client resmi untuk NexaBase: Platform Sinkronisasi NoSQL, Realtime, File Storage, & Autentikasi Offline-First.",
   "main": "dist/index.cjs",
   "module": "dist/index.js",