@push.rocks/smartdb 1.0.1

package/dist_ts/ts_smartdb/engine/TransactionEngine.d.ts

@@ -0,0 +1,85 @@
+import * as plugins from '../plugins.js';
+import type { IStorageAdapter } from '../storage/IStorageAdapter.js';
+import type { IStoredDocument, ITransactionOptions } from '../types/interfaces.js';
+/**
+ * Transaction state
+ */
+export interface ITransactionState {
+    id: string;
+    sessionId: string;
+    startTime: plugins.bson.Timestamp;
+    status: 'active' | 'committed' | 'aborted';
+    readSet: Map<string, Set<string>>;
+    writeSet: Map<string, Map<string, {
+        op: 'insert' | 'update' | 'delete';
+        doc?: IStoredDocument;
+        originalDoc?: IStoredDocument;
+    }>>;
+    snapshots: Map<string, IStoredDocument[]>;
+}
+/**
+ * Transaction engine for ACID transaction support
+ */
+export declare class TransactionEngine {
+    private storage;
+    private transactions;
+    private txnCounter;
+    constructor(storage: IStorageAdapter);
+    /**
+     * Start a new transaction
+     */
+    startTransaction(sessionId: string, options?: ITransactionOptions): string;
+    /**
+     * Get a transaction by ID
+     */
+    getTransaction(txnId: string): ITransactionState | undefined;
+    /**
+     * Check if a transaction is active
+     */
+    isActive(txnId: string): boolean;
+    /**
+     * Get or create a snapshot for a namespace
+     */
+    getSnapshot(txnId: string, dbName: string, collName: string): Promise<IStoredDocument[]>;
+    /**
+     * Record a read operation
+     */
+    recordRead(txnId: string, dbName: string, collName: string, docIds: string[]): void;
+    /**
+     * Record a write operation (insert)
+     */
+    recordInsert(txnId: string, dbName: string, collName: string, doc: IStoredDocument): void;
+    /**
+     * Record a write operation (update)
+     */
+    recordUpdate(txnId: string, dbName: string, collName: string, originalDoc: IStoredDocument, updatedDoc: IStoredDocument): void;
+    /**
+     * Record a write operation (delete)
+     */
+    recordDelete(txnId: string, dbName: string, collName: string, doc: IStoredDocument): void;
+    /**
+     * Commit a transaction
+     */
+    commitTransaction(txnId: string): Promise<void>;
+    /**
+     * Abort a transaction
+     */
+    abortTransaction(txnId: string): Promise<void>;
+    /**
+     * End a transaction (cleanup)
+     */
+    endTransaction(txnId: string): void;
+    /**
+     * Get all pending writes for a namespace
+     */
+    getPendingWrites(txnId: string, dbName: string, collName: string): Map<string, {
+        op: 'insert' | 'update' | 'delete';
+        doc?: IStoredDocument;
+    }> | undefined;
+    /**
+     * Execute a callback within a transaction, with automatic retry on conflict
+     */
+    withTransaction<T>(sessionId: string, callback: (txnId: string) => Promise<T>, options?: ITransactionOptions & {
+        maxRetries?: number;
+    }): Promise<T>;
+}

package/dist_ts/ts_smartdb/engine/TransactionEngine.js

@@ -0,0 +1,287 @@
+import * as plugins from '../plugins.js';
+import { SmartdbTransactionError, SmartdbWriteConflictError } from '../errors/SmartdbErrors.js';
+/**
+ * Transaction engine for ACID transaction support
+ */
+export class TransactionEngine {
+    storage;
+    transactions = new Map();
+    txnCounter = 0;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * Start a new transaction
+     */
+    startTransaction(sessionId, options) {
+        this.txnCounter++;
+        const txnId = `txn_${sessionId}_${this.txnCounter}`;
+        const transaction = {
+            id: txnId,
+            sessionId,
+            startTime: new plugins.bson.Timestamp({ t: Math.floor(Date.now() / 1000), i: this.txnCounter }),
+            status: 'active',
+            readSet: new Map(),
+            writeSet: new Map(),
+            snapshots: new Map(),
+        };
+        this.transactions.set(txnId, transaction);
+        return txnId;
+    }
+    /**
+     * Get a transaction by ID
+     */
+    getTransaction(txnId) {
+        return this.transactions.get(txnId);
+    }
+    /**
+     * Check if a transaction is active
+     */
+    isActive(txnId) {
+        const txn = this.transactions.get(txnId);
+        return txn?.status === 'active';
+    }
+    /**
+     * Get or create a snapshot for a namespace
+     */
+    async getSnapshot(txnId, dbName, collName) {
+        const txn = this.transactions.get(txnId);
+        if (!txn || txn.status !== 'active') {
+            throw new SmartdbTransactionError('Transaction is not active');
+        }
+        const ns = `${dbName}.${collName}`;
+        if (!txn.snapshots.has(ns)) {
+            const snapshot = await this.storage.createSnapshot(dbName, collName);
+            txn.snapshots.set(ns, snapshot);
+        }
+        // Apply transaction writes to snapshot
+        const snapshot = txn.snapshots.get(ns);
+        const writes = txn.writeSet.get(ns);
+        if (!writes) {
+            return snapshot;
+        }
+        // Create a modified view of the snapshot
+        const result = [];
+        const deletedIds = new Set();
+        const modifiedDocs = new Map();
+        for (const [idStr, write] of writes) {
+            if (write.op === 'delete') {
+                deletedIds.add(idStr);
+            }
+            else if (write.op === 'update' || write.op === 'insert') {
+                if (write.doc) {
+                    modifiedDocs.set(idStr, write.doc);
+                }
+            }
+        }
+        // Add existing documents (not deleted, possibly modified)
+        for (const doc of snapshot) {
+            const idStr = doc._id.toHexString();
+            if (deletedIds.has(idStr)) {
+                continue;
+            }
+            if (modifiedDocs.has(idStr)) {
+                result.push(modifiedDocs.get(idStr));
+                modifiedDocs.delete(idStr);
+            }
+            else {
+                result.push(doc);
+            }
+        }
+        // Add new documents (inserts)
+        for (const doc of modifiedDocs.values()) {
+            result.push(doc);
+        }
+        return result;
+    }
+    /**
+     * Record a read operation
+     */
+    recordRead(txnId, dbName, collName, docIds) {
+        const txn = this.transactions.get(txnId);
+        if (!txn || txn.status !== 'active')
+            return;
+        const ns = `${dbName}.${collName}`;
+        if (!txn.readSet.has(ns)) {
+            txn.readSet.set(ns, new Set());
+        }
+        const readSet = txn.readSet.get(ns);
+        for (const id of docIds) {
+            readSet.add(id);
+        }
+    }
+    /**
+     * Record a write operation (insert)
+     */
+    recordInsert(txnId, dbName, collName, doc) {
+        const txn = this.transactions.get(txnId);
+        if (!txn || txn.status !== 'active') {
+            throw new SmartdbTransactionError('Transaction is not active');
+        }
+        const ns = `${dbName}.${collName}`;
+        if (!txn.writeSet.has(ns)) {
+            txn.writeSet.set(ns, new Map());
+        }
+        txn.writeSet.get(ns).set(doc._id.toHexString(), {
+            op: 'insert',
+            doc,
+        });
+    }
+    /**
+     * Record a write operation (update)
+     */
+    recordUpdate(txnId, dbName, collName, originalDoc, updatedDoc) {
+        const txn = this.transactions.get(txnId);
+        if (!txn || txn.status !== 'active') {
+            throw new SmartdbTransactionError('Transaction is not active');
+        }
+        const ns = `${dbName}.${collName}`;
+        if (!txn.writeSet.has(ns)) {
+            txn.writeSet.set(ns, new Map());
+        }
+        const idStr = originalDoc._id.toHexString();
+        const existing = txn.writeSet.get(ns).get(idStr);
+        // If we already have a write for this document, update it
+        if (existing) {
+            existing.doc = updatedDoc;
+        }
+        else {
+            txn.writeSet.get(ns).set(idStr, {
+                op: 'update',
+                doc: updatedDoc,
+                originalDoc,
+            });
+        }
+    }
+    /**
+     * Record a write operation (delete)
+     */
+    recordDelete(txnId, dbName, collName, doc) {
+        const txn = this.transactions.get(txnId);
+        if (!txn || txn.status !== 'active') {
+            throw new SmartdbTransactionError('Transaction is not active');
+        }
+        const ns = `${dbName}.${collName}`;
+        if (!txn.writeSet.has(ns)) {
+            txn.writeSet.set(ns, new Map());
+        }
+        const idStr = doc._id.toHexString();
+        const existing = txn.writeSet.get(ns).get(idStr);
+        if (existing && existing.op === 'insert') {
+            // If we inserted and then deleted, just remove the write
+            txn.writeSet.get(ns).delete(idStr);
+        }
+        else {
+            txn.writeSet.get(ns).set(idStr, {
+                op: 'delete',
+                originalDoc: doc,
+            });
+        }
+    }
+    /**
+     * Commit a transaction
+     */
+    async commitTransaction(txnId) {
+        const txn = this.transactions.get(txnId);
+        if (!txn) {
+            throw new SmartdbTransactionError('Transaction not found');
+        }
+        if (txn.status !== 'active') {
+            throw new SmartdbTransactionError(`Cannot commit transaction in state: ${txn.status}`);
+        }
+        // Check for write conflicts
+        for (const [ns, writes] of txn.writeSet) {
+            const [dbName, collName] = ns.split('.');
+            const ids = Array.from(writes.keys()).map(id => new plugins.bson.ObjectId(id));
+            const hasConflicts = await this.storage.hasConflicts(dbName, collName, ids, txn.startTime);
+            if (hasConflicts) {
+                txn.status = 'aborted';
+                throw new SmartdbWriteConflictError();
+            }
+        }
+        // Apply all writes
+        for (const [ns, writes] of txn.writeSet) {
+            const [dbName, collName] = ns.split('.');
+            for (const [idStr, write] of writes) {
+                switch (write.op) {
+                    case 'insert':
+                        if (write.doc) {
+                            await this.storage.insertOne(dbName, collName, write.doc);
+                        }
+                        break;
+                    case 'update':
+                        if (write.doc) {
+                            await this.storage.updateById(dbName, collName, new plugins.bson.ObjectId(idStr), write.doc);
+                        }
+                        break;
+                    case 'delete':
+                        await this.storage.deleteById(dbName, collName, new plugins.bson.ObjectId(idStr));
+                        break;
+                }
+            }
+        }
+        txn.status = 'committed';
+    }
+    /**
+     * Abort a transaction
+     */
+    async abortTransaction(txnId) {
+        const txn = this.transactions.get(txnId);
+        if (!txn) {
+            throw new SmartdbTransactionError('Transaction not found');
+        }
+        if (txn.status !== 'active') {
+            // Already committed or aborted, just return
+            return;
+        }
+        // Simply discard all buffered writes
+        txn.writeSet.clear();
+        txn.readSet.clear();
+        txn.snapshots.clear();
+        txn.status = 'aborted';
+    }
+    /**
+     * End a transaction (cleanup)
+     */
+    endTransaction(txnId) {
+        this.transactions.delete(txnId);
+    }
+    /**
+     * Get all pending writes for a namespace
+     */
+    getPendingWrites(txnId, dbName, collName) {
+        const txn = this.transactions.get(txnId);
+        if (!txn)
+            return undefined;
+        const ns = `${dbName}.${collName}`;
+        return txn.writeSet.get(ns);
+    }
+    /**
+     * Execute a callback within a transaction, with automatic retry on conflict
+     */
+    async withTransaction(sessionId, callback, options) {
+        const maxRetries = options?.maxRetries ?? 3;
+        let lastError;
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            const txnId = this.startTransaction(sessionId, options);
+            try {
+                const result = await callback(txnId);
+                await this.commitTransaction(txnId);
+                this.endTransaction(txnId);
+                return result;
+            }
+            catch (error) {
+                await this.abortTransaction(txnId);
+                this.endTransaction(txnId);
+                if (error instanceof SmartdbWriteConflictError && attempt < maxRetries - 1) {
+                    // Retry on write conflict
+                    lastError = error;
+                    continue;
+                }
+                throw error;
+            }
+        }
+        throw lastError || new SmartdbTransactionError('Transaction failed after max retries');
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVHJhbnNhY3Rpb25FbmdpbmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy90c19zbWFydGRiL2VuZ2luZS9UcmFuc2FjdGlvbkVuZ2luZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUd6QyxPQUFPLEVBQUUsdUJBQXVCLEVBQUUseUJBQXlCLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQWVoRzs7R0FFRztBQUNILE1BQU0sT0FBTyxpQkFBaUI7SUFDcEIsT0FBTyxDQUFrQjtJQUN6QixZQUFZLEdBQW1DLElBQUksR0FBRyxFQUFFLENBQUM7SUFDekQsVUFBVSxHQUFHLENBQUMsQ0FBQztJQUV2QixZQUFZLE9BQXdCO1FBQ2xDLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxDQUFDO0lBQ3pCLENBQUM7SUFFRDs7T0FFRztJQUNILGdCQUFnQixDQUFDLFNBQWlCLEVBQUUsT0FBNkI7UUFDL0QsSUFBSSxDQUFDLFVBQVUsRUFBRSxDQUFDO1FBQ2xCLE1BQU0sS0FBSyxHQUFHLE9BQU8sU0FBUyxJQUFJLElBQUksQ0FBQyxVQUFVLEVBQUUsQ0FBQztRQUVwRCxNQUFNLFdBQVcsR0FBc0I7WUFDckMsRUFBRSxFQUFFLEtBQUs7WUFDVCxTQUFTO1lBQ1QsU0FBUyxFQUFFLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDLEVBQUUsSUFBSSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsR0FBRyxFQUFFLEdBQUcsSUFBSSxDQUFDLEVBQUUsQ0FBQyxFQUFFLElBQUksQ0FBQyxVQUFVLEVBQUUsQ0FBQztZQUMvRixNQUFNLEVBQUUsUUFBUTtZQUNoQixPQUFPLEVBQUUsSUFBSSxHQUFHLEVBQUU7WUFDbEIsUUFBUSxFQUFFLElBQUksR0FBRyxFQUFFO1lBQ25CLFNBQVMsRUFBRSxJQUFJLEdBQUcsRUFBRTtTQUNyQixDQUFDO1FBRUYsSUFB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

package/dist_ts/ts_smartdb/engine/UpdateEngine.d.ts

@@ -0,0 +1,47 @@
+import type { Document, IStoredDocument } from '../types/interfaces.js';
+/**
+ * Update engine for MongoDB-compatible update operations
+ */
+export declare class UpdateEngine {
+    /**
+     * Apply an update specification to a document
+     * Returns the updated document or null if no update was applied
+     */
+    static applyUpdate(document: IStoredDocument, update: Document, arrayFilters?: Document[]): IStoredDocument;
+    /**
+     * Apply $setOnInsert for upsert operations
+     */
+    static applySetOnInsert(document: IStoredDocument, setOnInsert: Document): IStoredDocument;
+    /**
+     * Deep clone a document
+     */
+    private static deepClone;
+    /**
+     * Set a nested value
+     */
+    private static setNestedValue;
+    /**
+     * Get a nested value
+     */
+    private static getNestedValue;
+    /**
+     * Delete a nested value
+     */
+    private static deleteNestedValue;
+    private static applySet;
+    private static applyUnset;
+    private static applyInc;
+    private static applyMul;
+    private static applyMin;
+    private static applyMax;
+    private static applyRename;
+    private static applyCurrentDate;
+    private static applyPush;
+    private static applyPop;
+    private static applyPull;
+    private static applyPullAll;
+    private static applyAddToSet;
+    private static applyBit;
+    private static compareValues;
+    private static valuesEqual;
+}