nexabase-console 2.0.2 → 2.0.4

package/README.md

@@ -142,6 +142,40 @@ const listenLiveChats = () => {
 };
 ```
 
+#### Agregasi Data & Hitung Dokumen (`getCountFromServer` / `getAggregateFromServer`)
+Mendukung fungsi agregasi server 1:1 seperti Firebase SDK: `getCountFromServer()`, `getAggregateFromServer()`, `count()`, `sum()`, dan `average()`.
+
+```javascript
+import { 
+  collection, 
+  query, 
+  where, 
+  getCountFromServer, 
+  getAggregateFromServer, 
+  count, 
+  sum, 
+  average 
+} from 'nexabase-console';
+
+// 1. Menghitung total dokumen (getCountFromServer)
+const productsRef = collection(db, 'products');
+const qAvailable = query(productsRef, where('status', '==', 'active'));
+
+const countSnapshot = await getCountFromServer(qAvailable);
+console.log("Total produk aktif:", countSnapshot.data().count);
+
+// 2. Agregasi multi-field (getAggregateFromServer)
+const orderStats = await getAggregateFromServer(collection(db, 'orders'), {
+  totalOrders: count(),
+  totalRevenue: sum('totalAmount'),
+  avgOrderValue: average('totalAmount')
+});
+
+console.log("Jumlah order:", orderStats.data().totalOrders);
+console.log("Total pendapatan:", orderStats.data().totalRevenue);
+console.log("Rata-rata transaksi:", orderStats.data().avgOrderValue);
+```
+
 #### Menggunakan Atomic Write Batch (Untuk Upload File / Excel Massal)
 Jika Anda mengunggah data sekaligus dalam jumlah besar dari file (misal: import 500 resi dari Excel), hindari memanggil `setDoc` satu per satu di dalam _looping_. Gunakan fitur `writeBatch` yang membundel seluruh operasi Anda dalam satu pengiriman jaringan (hingga 500 operasi per eksekusi).
 

package/dist/app/NexaApp.js

@@ -29,7 +29,7 @@ class NexaApp {
         }
         this.endpoint = config.endpoint || defaultEndpoint;
         // Transport
-        this.httpClient = new HttpClient_1.HttpClient(this.endpoint, () => this.authService ? this.authService.getToken() : this.token);
+        this.httpClient = new HttpClient_1.HttpClient(this.endpoint, () => (this.authService ? this.authService.getToken() : this.token), this.projectId, this.token);
         this.client = this.httpClient.getAxiosInstance();
         this.sseClient = new SSEClient_1.SSEClient(this.projectId, this.endpoint);
         // Auth & Persistence

package/dist/auth/Auth.js

@@ -165,9 +165,9 @@ class Auth {
         return this.refreshPromise;
     }
     async refreshAccessToken(refreshToken) {
-        const endpoint = this.emulatorUrl || `/api/project/${this.projectId}/auth/token/refresh`;
+        const endpoint = this.emulatorUrl || `/api/auth/token/refresh`;
         try {
-            const res = await this.client.post(endpoint, { refreshToken });
+            const res = await this.client.post(endpoint, { refreshToken, projectId: this.projectId });
             const session = res.data;
             this.currentSession = session;
             await this.persistence.saveSession(session);
@@ -203,8 +203,8 @@ class Auth {
     // --- Email & Password Auth ---
     async createUserWithEmailAndPassword(email, password, name) {
         try {
-            const endpoint = this.emulatorUrl || `/api/project/${this.projectId}/auth/register`;
-            const res = await this.client.post(endpoint, { email, password, name });
+            const endpoint = this.emulatorUrl || `/api/auth/register`;
+            const res = await this.client.post(endpoint, { email, password, name, projectId: this.projectId });
             const session = res.data;
             this.currentSession = session;
             await this.persistence.saveSession(session);
@@ -218,8 +218,8 @@ class Auth {
     }
     async signInWithEmailAndPassword(email, password) {
         try {
-            const endpoint = this.emulatorUrl || `/api/project/${this.projectId}/auth/login`;
-            const res = await this.client.post(endpoint, { email, password });
+            const endpoint = this.emulatorUrl || `/api/auth/login`;
+            const res = await this.client.post(endpoint, { email, password, projectId: this.projectId });
             const session = res.data;
             this.currentSession = session;
             await this.persistence.saveSession(session);
@@ -234,8 +234,8 @@ class Auth {
     // --- OTP Auth ---
     async sendOtp(email) {
         try {
-            const endpoint = this.emulatorUrl || `/api/project/${this.projectId}/auth/otp/send`;
-            const res = await this.client.post(endpoint, { email });
+            const endpoint = this.emulatorUrl || `/api/auth/otp/send`;
+            const res = await this.client.post(endpoint, { email, projectId: this.projectId });
             return res.data;
         }
         catch (err) {
@@ -244,8 +244,8 @@ class Auth {
     }
     async signInWithOtp(email, otp) {
         try {
-            const endpoint = this.emulatorUrl || `/api/project/${this.projectId}/auth/otp/login`;
-            const res = await this.client.post(endpoint, { email, otp });
+            const endpoint = this.emulatorUrl || `/api/auth/otp/login`;
+            const res = await this.client.post(endpoint, { email, otp, projectId: this.projectId });
             const session = res.data;
             this.currentSession = session;
             await this.persistence.saveSession(session);
@@ -260,8 +260,8 @@ class Auth {
     // --- Password Reset & Verification ---
     async sendPasswordResetEmail(email) {
         try {
-            const endpoint = this.emulatorUrl || `/api/project/${this.projectId}/auth/password-reset/send`;
-            const res = await this.client.post(endpoint, { email });
+            const endpoint = this.emulatorUrl || `/api/auth/password-reset/send`;
+            const res = await this.client.post(endpoint, { email, projectId: this.projectId });
             return res.data;
         }
         catch (err) {
@@ -270,8 +270,8 @@ class Auth {
     }
     async confirmPasswordReset(code, newPassword) {
         try {
-            const endpoint = this.emulatorUrl || `/api/project/${this.projectId}/auth/password-reset/confirm`;
-            const res = await this.client.post(endpoint, { code, newPassword });
+            const endpoint = this.emulatorUrl || `/api/auth/password-reset/confirm`;
+            const res = await this.client.post(endpoint, { code, newPassword, projectId: this.projectId });
             return res.data;
         }
         catch (err) {
@@ -281,8 +281,8 @@ class Auth {
     async sendEmailVerification() {
         const token = await this.getIdToken();
         try {
-            const endpoint = this.emulatorUrl || `/api/project/${this.projectId}/auth/email/send-verification`;
-            const res = await this.client.post(endpoint, {}, {
+            const endpoint = this.emulatorUrl || `/api/auth/email/send-verification`;
+            const res = await this.client.post(endpoint, { projectId: this.projectId }, {
                 headers: { Authorization: `Bearer ${token}` }
             });
             return res.data;
@@ -295,8 +295,8 @@ class Auth {
     async updateProfile(update) {
         const token = await this.getIdToken();
         try {
-            const endpoint = this.emulatorUrl || `/api/project/${this.projectId}/auth/profile`;
-            const res = await this.client.patch(endpoint, update, {
+            const endpoint = this.emulatorUrl || `/api/auth/profile`;
+            const res = await this.client.patch(endpoint, { ...update, projectId: this.projectId }, {
                 headers: { Authorization: `Bearer ${token}` }
             });
             const updatedUser = res.data;
@@ -314,8 +314,8 @@ class Auth {
     async updatePassword(newPassword) {
         const token = await this.getIdToken();
         try {
-            const endpoint = this.emulatorUrl || `/api/project/${this.projectId}/auth/password/update`;
-            await this.client.post(endpoint, { newPassword }, {
+            const endpoint = this.emulatorUrl || `/api/auth/password/update`;
+            await this.client.post(endpoint, { newPassword, projectId: this.projectId }, {
                 headers: { Authorization: `Bearer ${token}` }
             });
         }
@@ -326,9 +326,10 @@ class Auth {
     async deleteUser() {
         const token = await this.getIdToken();
         try {
-            const endpoint = this.emulatorUrl || `/api/project/${this.projectId}/auth/user/delete`;
+            const endpoint = this.emulatorUrl || `/api/auth/user/delete`;
             await this.client.delete(endpoint, {
-                headers: { Authorization: `Bearer ${token}` }
+                headers: { Authorization: `Bearer ${token}` },
+                data: { projectId: this.projectId }
             });
             await this.signOut();
         }
@@ -340,8 +341,8 @@ class Auth {
     async revokeSession(sessionId) {
         const token = await this.getIdToken();
         try {
-            const endpoint = this.emulatorUrl || `/api/project/${this.projectId}/auth/session/revoke`;
-            await this.client.post(endpoint, { sessionId }, {
+            const endpoint = this.emulatorUrl || `/api/auth/session/revoke`;
+            await this.client.post(endpoint, { sessionId, projectId: this.projectId }, {
                 headers: { Authorization: `Bearer ${token}` }
             });
         }
@@ -352,8 +353,8 @@ class Auth {
     async revokeAllSessions() {
         const token = await this.getIdToken();
         try {
-            const endpoint = this.emulatorUrl || `/api/project/${this.projectId}/auth/session/revoke-all`;
-            await this.client.post(endpoint, {}, {
+            const endpoint = this.emulatorUrl || `/api/auth/session/revoke-all`;
+            await this.client.post(endpoint, { projectId: this.projectId }, {
                 headers: { Authorization: `Bearer ${token}` }
             });
             await this.signOut();
@@ -368,8 +369,8 @@ class Auth {
         this.currentSession = null;
         if (oldSession) {
             try {
-                const endpoint = this.emulatorUrl || `/api/project/${this.projectId}/auth/logout`;
-                await this.client.post(endpoint, { refreshToken: oldSession.refreshToken });
+                const endpoint = this.emulatorUrl || `/api/auth/logout`;
+                await this.client.post(endpoint, { refreshToken: oldSession.refreshToken, projectId: this.projectId });
             }
             catch {
                 // Non-blocking logout network failure

package/dist/firestore/Query.d.ts

@@ -1,4 +1,12 @@
-import { CollectionReference, Query, QueryConstraint, QuerySnapshot } from '../types/index';
+import { FieldPath } from './FieldPath';
+import { CollectionReference, Query, QueryConstraint, QuerySnapshot, AggregateField, AggregateSpec, AggregateSpecData, AggregateQuerySnapshot } from '../types/index';
 export declare const query: <T = any>(queryObject: Query<T> | CollectionReference<T>, ...queryConstraints: QueryConstraint[]) => Query<T>;
 export declare const getCachedDocs: <T = any>(queryOrCollection: Query<T> | CollectionReference<T>) => QuerySnapshot<T>;
 export declare const getDocs: <T = any>(queryOrCollection: Query<T> | CollectionReference<T>) => Promise<QuerySnapshot<T>>;
+export declare const count: () => AggregateField<number>;
+export declare const sum: (field: string | FieldPath) => AggregateField<number>;
+export declare const average: (field: string | FieldPath) => AggregateField<number | null>;
+export declare const getAggregateFromServer: <T extends AggregateSpec>(queryOrCollection: Query<any> | CollectionReference<any>, aggregateSpec: T) => Promise<AggregateQuerySnapshot<AggregateSpecData<T>>>;
+export declare const getCountFromServer: <T = any>(queryOrCollection: Query<T> | CollectionReference<T>) => Promise<AggregateQuerySnapshot<{
+    count: number;
+}>>;

package/dist/firestore/Query.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDocs = exports.getCachedDocs = exports.query = void 0;
+exports.getCountFromServer = exports.getAggregateFromServer = exports.average = exports.sum = exports.count = exports.getDocs = exports.getCachedDocs = exports.query = void 0;
 const SnapshotManager_1 = require("./SnapshotManager");
 const DocumentReference_1 = require("./DocumentReference");
 const NexaError_1 = require("../errors/NexaError");
@@ -174,3 +174,64 @@ const getDocs = async (queryOrCollection) => {
     }
 };
 exports.getDocs = getDocs;
+const count = () => {
+    return { type: 'count' };
+};
+exports.count = count;
+const sum = (field) => {
+    return { type: 'sum', fieldPath: field };
+};
+exports.sum = sum;
+const average = (field) => {
+    return { type: 'average', fieldPath: field };
+};
+exports.average = average;
+const getAggregateFromServer = async (queryOrCollection, aggregateSpec) => {
+    const querySnapshot = await (0, exports.getDocs)(queryOrCollection);
+    const docs = querySnapshot.docs;
+    const resultData = {};
+    for (const [key, spec] of Object.entries(aggregateSpec)) {
+        if (spec.type === 'count') {
+            resultData[key] = docs.length;
+        }
+        else if (spec.type === 'sum') {
+            const field = spec.fieldPath || '';
+            let sumVal = 0;
+            for (const d of docs) {
+                const val = (0, helpers_1.getNestedValue)(d.data(), field, d.id);
+                if (typeof val === 'number' && !isNaN(val)) {
+                    sumVal += val;
+                }
+            }
+            resultData[key] = sumVal;
+        }
+        else if (spec.type === 'average') {
+            const field = spec.fieldPath || '';
+            let sumVal = 0;
+            let countVal = 0;
+            for (const d of docs) {
+                const val = (0, helpers_1.getNestedValue)(d.data(), field, d.id);
+                if (typeof val === 'number' && !isNaN(val)) {
+                    sumVal += val;
+                    countVal++;
+                }
+            }
+            resultData[key] = countVal > 0 ? sumVal / countVal : null;
+        }
+    }
+    return {
+        type: 'AggregateQuerySnapshot',
+        query: queryOrCollection,
+        data: () => resultData
+    };
+};
+exports.getAggregateFromServer = getAggregateFromServer;
+const getCountFromServer = async (queryOrCollection) => {
+    const querySnapshot = await (0, exports.getDocs)(queryOrCollection);
+    return {
+        type: 'AggregateQuerySnapshot',
+        query: queryOrCollection,
+        data: () => ({ count: querySnapshot.docs.length })
+    };
+};
+exports.getCountFromServer = getCountFromServer;

package/dist/transport/HttpClient.d.ts

@@ -2,7 +2,9 @@ import { AxiosInstance } from 'axios';
 export declare class HttpClient {
     private client;
     private getToken;
-    constructor(endpoint: string, getTokenFn: () => string | null);
+    private projectId?;
+    private apiKey?;
+    constructor(endpoint: string, getTokenFn: () => string | null, projectId?: string, apiKey?: string | null);
     getAxiosInstance(): AxiosInstance;
     setBaseURL(url: string): void;
 }

package/dist/transport/HttpClient.js

@@ -6,18 +6,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HttpClient = void 0;
 const axios_1 = __importDefault(require("axios"));
 class HttpClient {
-    constructor(endpoint, getTokenFn) {
+    constructor(endpoint, getTokenFn, projectId, apiKey) {
         this.getToken = getTokenFn;
+        this.projectId = projectId;
+        this.apiKey = apiKey;
         this.client = axios_1.default.create({
             baseURL: endpoint,
-            timeout: 6000
+            timeout: 10000
         });
         this.client.interceptors.request.use((req) => {
             const activeToken = this.getToken();
             if (activeToken) {
                 req.headers.Authorization = `Bearer ${activeToken}`;
+            }
+            if (this.apiKey) {
+                req.headers['x-api-key'] = this.apiKey;
+            }
+            else if (activeToken) {
                 req.headers['x-api-key'] = activeToken;
             }
+            if (this.projectId) {
+                req.headers['x-project-id'] = this.projectId;
+            }
             if (typeof FormData !== 'undefined' && req.data instanceof FormData) {
                 if (req.headers) {
                     delete req.headers['Content-Type'];

package/dist/types/index.d.ts

@@ -77,6 +77,22 @@ export interface QuerySnapshot<T = any> {
     metadata: SnapshotMetadata;
     docChanges: () => DocumentChange<T>[];
 }
+export interface AggregateField<T = number> {
+    type: 'count' | 'sum' | 'average';
+    fieldPath?: string | FieldPath;
+    _returnType?: T;
+}
+export type AggregateSpec = Record<string, AggregateField<any>>;
+export type AggregateSpecData<T extends AggregateSpec> = {
+    [K in keyof T]: T[K] extends AggregateField<infer R> ? R : number;
+};
+export interface AggregateQuerySnapshot<T extends Record<string, any> = {
+    count: number;
+}> {
+    type: 'AggregateQuerySnapshot';
+    query: Query<any> | CollectionReference<any>;
+    data: () => T;
+}
 export interface DatabaseReference {
     path: string;
     get: () => Promise<any>;

package/package.json

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