nexabase-console 2.1.0 → 2.1.2

package/dist/app/NexaApp.d.ts

@@ -36,6 +36,7 @@ export declare class NexaApp {
     get _firestoreCache(): Record<string, any>;
     private _setupCrossTabSync;
     _broadcastLocalMutation(path: string, action: string, data?: any): void;
+    getPendingWritesCount(): number;
     hasPendingWrites(path: string): boolean;
     markInflight(path: string, mutationId: string): void;
     unmarkInflight(path: string, mutationId: string): void;

package/dist/app/NexaApp.js

@@ -66,6 +66,12 @@ class NexaApp {
     _broadcastLocalMutation(path, action, data) {
         this.syncEngine.broadcastLocalMutation(path, action, data);
     }
+    getPendingWritesCount() {
+        if (!this.mutationQueue)
+            return 0;
+        const queue = this.mutationQueue.inMemoryQueue || [];
+        return queue.length;
+    }
     hasPendingWrites(path) {
         return this.mutationQueue.hasPendingWrites(path);
     }
@@ -376,6 +382,8 @@ class NexaApp {
         this._closeFirestoreSSEIfIdle();
     }
     _notifySnapshotCallbacks(path, actionType, payload) {
+        if (!path || typeof path !== 'string')
+            return;
         Object.keys(this._snapshotCallbacks).forEach((cbKey) => {
             const parts = cbKey.split('_');
             const targetPath = parts.slice(2).join('_');

package/dist/firestore/FieldValue.d.ts

@@ -9,3 +9,5 @@ export declare const increment: (n: number) => FieldValue;
 export declare const arrayUnion: (...elements: any[]) => FieldValue;
 export declare const arrayRemove: (...elements: any[]) => FieldValue;
 export declare const deleteField: () => FieldValue;
+export declare const atomicIncrement: (n: number) => FieldValue;
+export declare const atomicDecrement: (n: number) => FieldValue;

package/dist/firestore/FieldValue.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deleteField = exports.arrayRemove = exports.arrayUnion = exports.increment = exports.serverTimestamp = exports.FieldValue = void 0;
+exports.atomicDecrement = exports.atomicIncrement = exports.deleteField = exports.arrayRemove = exports.arrayUnion = exports.increment = exports.serverTimestamp = exports.FieldValue = void 0;
 class FieldValue {
     constructor(method, value) {
         this.method = method;
@@ -19,3 +19,8 @@ const arrayRemove = (...elements) => new FieldValue('arrayRemove', elements);
 exports.arrayRemove = arrayRemove;
 const deleteField = () => new FieldValue('deleteField');
 exports.deleteField = deleteField;
+// Helper methods for Offline-First operations (e.g. POS/Inventory systems)
+const atomicIncrement = (n) => new FieldValue('increment', Math.abs(n));
+exports.atomicIncrement = atomicIncrement;
+const atomicDecrement = (n) => new FieldValue('increment', -Math.abs(n));
+exports.atomicDecrement = atomicDecrement;

package/dist/firestore/transaction.js

@@ -17,12 +17,15 @@ const runTransaction = async (db, updateFunction, options) => {
                 let res;
                 try {
                     if (typeof navigator !== 'undefined' && !navigator.onLine) {
-                        throw new Error('offline');
+                        throw Object.assign(new Error('NEXA_ERR_TRANSACTION_OFFLINE'), { code: 'NEXA_ERR_TRANSACTION_OFFLINE' });
                     }
                     res = await db.client.get(`/api/firestore/${db.projectId}/documentWithMetadata?docPath=${encodeURIComponent(docRef.path)}`);
                 }
                 catch (err) {
-                    throw (0, NexaError_1.toNexaError)(new Error('Transaction failed: Perangkat sedang offline atau jaringan terputus. Transaksi memerlukan koneksi aktif.'));
+                    if (err?.code === 'NEXA_ERR_TRANSACTION_OFFLINE' || err?.message === 'NEXA_ERR_TRANSACTION_OFFLINE') {
+                        throw Object.assign(new Error('Transaction failed: Perangkat sedang offline atau jaringan terputus. Transaksi memerlukan koneksi aktif. Gunakan writeBatch atau runOfflineSafeTransaction untuk operasi offline.'), { code: 'NEXA_ERR_TRANSACTION_OFFLINE' });
+                    }
+                    throw (0, NexaError_1.toNexaError)(err);
                 }
                 const { data, updatedAt } = res.data;
                 reads.push({ path: docRef.path, readUpdatedAt: updatedAt });
@@ -48,7 +51,7 @@ const runTransaction = async (db, updateFunction, options) => {
         const result = await updateFunction(transaction);
         if (operations.length > 0 || reads.length > 0) {
             if (typeof navigator !== 'undefined' && !navigator.onLine) {
-                throw (0, NexaError_1.toNexaError)(new Error('Transaction failed: Perangkat sedang offline atau jaringan terputus. Transaksi memerlukan koneksi aktif.'));
+                throw Object.assign(new Error('Transaction failed: Perangkat sedang offline atau jaringan terputus. Transaksi memerlukan koneksi aktif. Gunakan writeBatch atau runOfflineSafeTransaction untuk operasi offline.'), { code: 'NEXA_ERR_TRANSACTION_OFFLINE' });
             }
             await db.client.post(`/api/firestore/${db.projectId}/transaction`, { reads, operations, idempotencyKey }, { headers: { 'X-Idempotency-Key': idempotencyKey } });
         }

package/dist/firestore/writes.d.ts

@@ -1,3 +1,4 @@
+import { NexaApp } from "../app/NexaApp";
 import { DocumentReference } from '../types/index';
 export { FieldValue } from './FieldValue';
 export type WriteResult<T = unknown> = {
@@ -26,3 +27,4 @@ export declare const updateDoc: (docRef: DocumentReference, data: any, options?:
 export declare const deleteDoc: (docRef: DocumentReference, options?: {
     idempotencyKey?: string;
 }) => Promise<WriteResult>;
+export declare const getPendingWritesCount: (db: NexaApp) => number;

package/dist/firestore/writes.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deleteDoc = exports.updateDoc = exports.patchDoc = exports.setDoc = exports.FieldValue = void 0;
+exports.getPendingWritesCount = exports.deleteDoc = exports.updateDoc = exports.patchDoc = exports.setDoc = exports.FieldValue = void 0;
 const helpers_1 = require("../utils/helpers");
 var FieldValue_1 = require("./FieldValue");
 Object.defineProperty(exports, "FieldValue", { enumerable: true, get: function () { return FieldValue_1.FieldValue; } });
@@ -209,3 +209,7 @@ const deleteDoc = async (docRef, options) => {
     return executeWriteMutation(docRef, 'delete', null, options);
 };
 exports.deleteDoc = deleteDoc;
+const getPendingWritesCount = (db) => {
+    return db.getPendingWritesCount();
+};
+exports.getPendingWritesCount = getPendingWritesCount;

package/package.json

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