nexabase-console 1.0.1 → 1.0.3

package/dist/index.d.ts

@@ -22,35 +22,36 @@ export interface QueryConstraint {
     directionStr?: 'asc' | 'desc';
     limitValue?: number;
 }
-export interface DocumentReference {
+export interface DocumentReference<T = any> {
     type: 'document';
     path: string;
     db: NexaApp;
 }
-export interface CollectionReference {
+export interface CollectionReference<T = any> {
     type: 'collection';
     path: string;
     db: NexaApp;
 }
-export interface Query {
+export interface Query<T = any> {
     type: 'query' | 'collection';
     path: string;
     db: NexaApp;
     constraints?: QueryConstraint[];
 }
-export interface DocumentSnapshot {
+export interface DocumentSnapshot<T = any> {
     exists: () => boolean;
-    data: () => any | null;
+    data: () => T | null;
 }
-export interface QueryDocumentSnapshot {
+export interface QueryDocumentSnapshot<T = any> {
     id: string;
-    data: () => any;
+    data: () => T;
 }
-export interface QuerySnapshot {
-    docs: QueryDocumentSnapshot[];
-    forEach: (callback: (doc: QueryDocumentSnapshot) => void) => void;
+export interface QuerySnapshot<T = any> {
+    docs: QueryDocumentSnapshot<T>[];
+    forEach: (callback: (doc: QueryDocumentSnapshot<T>) => void) => void;
     empty: boolean;
     size: number;
+    docChanges?: () => any[];
 }
 export interface DatabaseReference {
     get: () => Promise<any>;
@@ -123,17 +124,17 @@ export declare class NexaApp {
 }
 export declare const initializeApp: (config: NexaConfig) => NexaApp;
 export declare const getFirestore: (app: NexaApp) => NexaApp;
-export declare const collection: (db: NexaApp, collectionPath: string) => CollectionReference;
-export declare const doc: (dbOrCollection: NexaApp | CollectionReference, ...pathSegments: string[]) => DocumentReference;
-export declare const query: (queryObject: Query | CollectionReference, ...queryConstraints: QueryConstraint[]) => Query;
+export declare const collection: <T = any>(db: NexaApp, collectionPath: string) => CollectionReference<T>;
+export declare const doc: <T = any>(dbOrCollection: NexaApp | CollectionReference<any>, ...pathSegments: string[]) => DocumentReference<T>;
+export declare const query: <T = any>(queryObject: Query<T> | CollectionReference<T>, ...queryConstraints: QueryConstraint[]) => Query<T>;
 export declare const where: (fieldPath: string, opStr: "==" | ">" | "<" | ">=" | "<=" | "!=", value: any) => QueryConstraint;
 export declare const orderBy: (fieldPath: string, directionStr?: "asc" | "desc") => QueryConstraint;
 export declare const limit: (limitValue: number) => QueryConstraint;
-export declare const getDocs: (queryOrCollection: Query | CollectionReference) => Promise<QuerySnapshot>;
-export declare const getDoc: (docRef: DocumentReference) => Promise<DocumentSnapshot>;
+export declare const getDocs: <T = any>(queryOrCollection: Query<T> | CollectionReference<T>) => Promise<QuerySnapshot<T>>;
+export declare const getDoc: <T = any>(docRef: DocumentReference<T>) => Promise<DocumentSnapshot<T>>;
 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

@@ -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,8 +472,11 @@ 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 };
+        return { exists: () => !!data, data: () => (data || null) };
     }
 };
 exports.getDoc = getDoc;
@@ -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.1",
+  "version": "1.0.3",
   "description": "SDK Client resmi untuk NexaBase: Platform Sinkronisasi NoSQL, Realtime, File Storage, & Autentikasi Offline-First.",
   "main": "dist/index.cjs",
   "module": "dist/index.js",