nexabase-console 2.0.9 → 2.1.1

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;
@@ -57,6 +58,8 @@ export declare class NexaApp {
         action: 'set' | 'patch' | 'delete';
         serverDocument?: any;
         updateTime?: string;
+        mutationData?: any;
+        merge?: boolean;
     }): Promise<{
         data: any | null;
         hasPendingWrites: boolean;

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);
     }
@@ -166,14 +172,31 @@ class NexaApp {
         const db = this.indexedDB.getRawDB();
         const queue = this.mutationQueue.inMemoryQueue;
         const jobIndex = queue.findIndex((j) => j.id === mutationId);
-        if (jobIndex !== -1)
+        let jobData = null;
+        if (jobIndex !== -1) {
+            jobData = queue[jobIndex];
             queue.splice(jobIndex, 1);
+        }
         if (options.action === 'delete') {
             this.localStore.getServerBaseCache()[path] = null;
         }
         else if (serverDocument && serverDocument.fields) {
             this.localStore.getServerBaseCache()[path] = (0, QueryUtils_1.reviveNexaData)(serverDocument.fields);
         }
+        else {
+            // PROMOTION: If server returned success: true without serverDocument.fields (lightweight ACK),
+            // promote the local mutation payload to Server Base Cache so the document does not revert to null!
+            const rawData = (jobData ? jobData.data : options.mutationData) || {};
+            const isMerge = jobData ? jobData.merge : options.merge;
+            let currentBase = this.localStore.getServerBaseCache()[path];
+            currentBase = currentBase !== undefined && currentBase !== null ? (0, QueryUtils_1.cloneNexaData)(currentBase) : currentBase;
+            if (options.action === 'set' && !isMerge) {
+                this.localStore.getServerBaseCache()[path] = (0, QueryUtils_1.reviveNexaData)((0, helpers_1.applyDataTransforms)({}, rawData));
+            }
+            else {
+                this.localStore.getServerBaseCache()[path] = (0, QueryUtils_1.reviveNexaData)((0, helpers_1.applyDataTransforms)(currentBase || {}, rawData));
+            }
+        }
         const view = this._calculateLocalView(path);
         const rebasedData = view.data;
         if (rebasedData === null) {

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; } });
@@ -173,7 +173,9 @@ const executeWriteMutation = async (docRef, action, data, options) => {
             path: docRef.path,
             action,
             serverDocument: res.document,
-            updateTime: res.document?.updateTime
+            updateTime: res.document?.updateTime,
+            mutationData: data,
+            merge: options?.merge
         });
     }
     catch (ackError) {
@@ -207,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.0.9",
+  "version": "2.1.1",
   "description": "SDK Client resmi untuk NexaBase: Platform Sinkronisasi NoSQL, Realtime, File Storage, & Autentikasi Offline-First.",
   "main": "dist/index.cjs",
   "module": "dist/index.js",