nexabase-console 1.0.5 → 1.0.6

package/dist/index.d.ts

@@ -152,4 +152,13 @@ export declare const onSnapshot: (ref: CollectionReference | DocumentReference |
 export declare const enableIndexedDbPersistence: (db: NexaApp) => Promise<void>;
 export declare const enableOfflinePersistence: (db: NexaApp) => Promise<void>;
 export declare const writeBatch: (db: NexaApp) => WriteBatch;
+export interface Transaction {
+    get: <T = any>(docRef: DocumentReference<T>) => Promise<DocumentSnapshot<T>>;
+    set: (docRef: DocumentReference, data: any) => Transaction;
+    update: (docRef: DocumentReference, data: any) => Transaction;
+    delete: (docRef: DocumentReference) => Transaction;
+}
+export declare const runTransaction: <T = any>(db: NexaApp, updateFunction: (transaction: Transaction) => Promise<T>, options?: {
+    maxAttempts?: number;
+}) => Promise<T>;
 export {};

package/dist/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.writeBatch = exports.enableOfflinePersistence = exports.enableIndexedDbPersistence = exports.onSnapshot = exports.deleteDoc = exports.updateDoc = exports.setDoc = exports.getDoc = exports.getDocs = exports.getCachedDoc = exports.getCachedDocs = exports.limit = exports.orderBy = exports.where = exports.query = exports.doc = exports.collection = exports.getFirestore = exports.initializeApp = exports.NexaApp = void 0;
+exports.runTransaction = exports.writeBatch = exports.enableOfflinePersistence = exports.enableIndexedDbPersistence = exports.onSnapshot = exports.deleteDoc = exports.updateDoc = exports.setDoc = exports.getDoc = exports.getDocs = exports.getCachedDoc = exports.getCachedDocs = exports.limit = exports.orderBy = exports.where = exports.query = exports.doc = exports.collection = exports.getFirestore = exports.initializeApp = exports.NexaApp = void 0;
 const axios_1 = __importDefault(require("axios"));
 // -----------------------------------------------------------------
 // Main NexaApp SDK Class
@@ -762,3 +762,86 @@ const writeBatch = (db) => {
     return batchObj;
 };
 exports.writeBatch = writeBatch;
+const runTransaction = async (db, updateFunction, options) => {
+    if (db._initPromise)
+        await db._initPromise;
+    const maxAttempts = options?.maxAttempts ?? 5;
+    let attempt = 0;
+    while (true) {
+        attempt++;
+        const reads = [];
+        const operations = [];
+        const transaction = {
+            get: async (docRef) => {
+                const segments = docRef.path.split('/');
+                const docId = segments[segments.length - 1];
+                const res = await db.client.get(`/api/firestore/${db.projectId}/documentWithMetadata?docPath=${encodeURIComponent(docRef.path)}`);
+                const { data, updatedAt } = res.data;
+                reads.push({ path: docRef.path, readUpdatedAt: updatedAt });
+                return {
+                    id: docId,
+                    ref: docRef,
+                    exists: () => !!data,
+                    data: () => data
+                };
+            },
+            set: (docRef, data) => {
+                operations.push({ type: 'set', path: docRef.path, data });
+                return transaction;
+            },
+            update: (docRef, data) => {
+                operations.push({ type: 'update', path: docRef.path, data });
+                return transaction;
+            },
+            delete: (docRef) => {
+                operations.push({ type: 'delete', path: docRef.path });
+                return transaction;
+            }
+        };
+        try {
+            const result = await updateFunction(transaction);
+            if (operations.length > 0 || reads.length > 0) {
+                await db.client.post(`/api/firestore/${db.projectId}/transaction`, {
+                    reads,
+                    operations
+                });
+            }
+            for (const op of operations) {
+                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((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] });
+                        }
+                    });
+                }
+                else if (op.type === 'delete') {
+                    await db._deleteCache(op.path);
+                    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 });
+                        }
+                    });
+                }
+            }
+            return result;
+        }
+        catch (err) {
+            const isConflict = err && err.response && err.response.status === 409;
+            if (isConflict && attempt < maxAttempts) {
+                console.warn(`[NexaBase Transaction] Retrying due to concurrency conflict (Attempt ${attempt}/${maxAttempts})`);
+                await new Promise((resolve) => setTimeout(resolve, Math.random() * 100 * attempt));
+                continue;
+            }
+            throw err;
+        }
+    }
+};
+exports.runTransaction = runTransaction;

package/package.json

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