axiodb 7.33.235 → 8.33.236

package/.dockerignore

@@ -0,0 +1,73 @@
+# Git
+.git/
+.gitignore
+.gitattributes
+.github/
+
+# Node modules (will be installed in container)
+node_modules/
+npm-debug.log
+yarn-error.log
+package-lock.json
+
+# AI Assistant configurations (not needed in Docker)
+.agents/
+.claude/
+.codex/
+.cursor/
+.devin/
+.gemini/
+AGENTS.md
+CLAUDE.md
+GEMINI.md
+
+# IDE configurations
+.vscode/
+.idea/
+.devcontainer/
+
+# Documentation (not needed in runtime)
+Document/
+LEARN.md
+CODE_OF_CONDUCT.md
+CONTRIBUTING.md
+SECURITY.md
+
+# Development files
+.gitpod.yml
+.deepsource.toml
+docker-compose.yml
+eslint.config.mjs
+tsconfig.json
+
+# Source TypeScript files (only compiled lib/ needed)
+source/
+Test/
+test/
+*.test.js
+*.spec.js
+
+# Build artifacts
+dist/
+library/
+Cache/
+AxioDB/
+
+# GUI (built separately if needed)
+GUI/
+
+# Scripts (development only)
+Scripts/
+
+# OS files
+.DS_Store
+Thumbs.db
+*.swp
+*.swo
+*~
+
+# Temporary files
+*.log
+*.tmp
+tmp/
+temp/

package/README.md

@@ -1,9 +1,17 @@
 # AxioDB: The Pure JavaScript Alternative to SQLite
 
 [![npm version](https://badge.fury.io/js/axiodb.svg)](https://badge.fury.io/js/axiodb)
+[![npm downloads](https://img.shields.io/npm/dm/axiodb.svg)](https://www.npmjs.com/package/axiodb)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+[![Push to Registry](https://github.com/nexoral/AxioDB/actions/workflows/Push.yml/badge.svg?branch=main)](https://github.com/nexoral/AxioDB/actions/workflows/Push.yml)
 [![CodeQL](https://github.com/nexoral/AxioDB/actions/workflows/github-code-scanning/codeql/badge.svg?branch=main)](https://github.com/nexoral/AxioDB/actions/workflows/github-code-scanning/codeql)
 [![Socket Security](https://socket.dev/api/badge/npm/package/axiodb)](https://socket.dev/npm/package/axiodb)
-[![Push to Registry](https://github.com/nexoral/AxioDB/actions/workflows/Push.yml/badge.svg?branch=main)](https://github.com/nexoral/AxioDB/actions/workflows/Push.yml)
+
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org)
+[![Tested on Node.js](https://img.shields.io/badge/tested%20on-20%20%7C%2021%20%7C%2022%20%7C%2023%20%7C%2024%20(all%20LTS)-blue)](https://github.com/nexoral/AxioDB/actions/workflows/Push.yml)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.6-blue)](https://www.typescriptlang.org/)
+[![Zero Dependencies](https://img.shields.io/badge/dependencies-0%20native-success)](https://www.npmjs.com/package/axiodb)
 
 > **AxioDB** is an embedded NoSQL database for Node.js with MongoDB-style queries. Zero native dependencies, no compilation, no platform issues. Pure JavaScript from npm install to production. Think SQLite, but NoSQL with JavaScript queries—perfect for desktop apps, CLI tools, and embedded systems.
 

package/lib/Services/CRUD Operation/Delete.operation.d.ts

@@ -19,11 +19,13 @@ export default class DeleteOperation {
     /**
      * Deletes a single document that matches the base query.
      *
-     * This method:
+     * This method with ACID compliance:
      * 1. Loads all raw data from buffers
      * 2. Searches for documents matching the base query
      * 3. Selects the first matching document (applying sort if provided)
-     * 4. Deletes the file associated with the selected document
+     * 4. Acquires lock on the document
+     * 5. Deletes the file associated with the selected document
+     * 6. Releases lock
      *
      * @returns {Promise<object>} A response object containing either:
      *   - Success: { message: "Data deleted successfully", deleteData: object }
@@ -35,15 +37,18 @@ export default class DeleteOperation {
     /**
      * Deletes multiple documents that match the base query.
      *
-     * This method:
+     * This method with ACID compliance:
      * 1. Searches for documents matching the base query
-     * 2. Deletes each matching file
-     * 3. Returns success with the deleted data or an error
+     * 2. Acquires locks on ALL matching documents (ensures atomicity)
+     * 3. Deletes each matching file
+     * 4. Releases all locks
+     * 5. Returns success with the deleted data or an error
      *
      * @returns {Promise<SuccessInterface | ErrorInterface>} A promise that resolves to either:
      *   - Success with a success message and the deleted data
      *   - Error if:
      *     - No matching data is found
+     *     - Lock acquisition fails
      *     - Any file deletion operation fails
      *     - The initial buffer data loading fails
      */

package/lib/Services/CRUD Operation/Delete.operation.js

@@ -18,6 +18,7 @@ const Crypto_helper_1 = require("../../Helper/Crypto.helper");
 const response_helper_1 = __importDefault(require("../../Helper/response.helper"));
 const DocumentLoader_helper_1 = __importDefault(require("../../Helper/DocumentLoader.helper"));
 const FileManager_1 = __importDefault(require("../../engine/Filesystem/FileManager"));
+const crypto_1 = require("crypto");
 // Import All Utility
 const Searcher_utils_1 = __importDefault(require("../../utility/Searcher.utils"));
 const SortData_utils_1 = __importDefault(require("../../utility/SortData.utils"));
@@ -25,6 +26,7 @@ const memory_operation_1 = __importDefault(require("../../Memory/memory.operatio
 const Keys_1 = require("../../config/Keys/Keys");
 const ReadIndex_service_1 = require("../Index/ReadIndex.service");
 const DeleteIndex_service_1 = __importDefault(require("../Index/DeleteIndex.service"));
+const LockManager_service_1 = __importDefault(require("../Transaction/LockManager.service"));
 /**
  * The DeleteOperation class is used to delete a document from a collection.
  * This class provides methods to delete a single document that matches the base query.
@@ -53,11 +55,13 @@ class DeleteOperation {
     /**
      * Deletes a single document that matches the base query.
      *
-     * This method:
+     * This method with ACID compliance:
      * 1. Loads all raw data from buffers
      * 2. Searches for documents matching the base query
      * 3. Selects the first matching document (applying sort if provided)
-     * 4. Deletes the file associated with the selected document
+     * 4. Acquires lock on the document
+     * 5. Deletes the file associated with the selected document
+     * 6. Releases lock
      *
      * @returns {Promise<object>} A response object containing either:
      *   - Success: { message: "Data deleted successfully", deleteData: object }
@@ -68,25 +72,32 @@ class DeleteOperation {
     deleteOne() {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;
-            // if documentId is provided in the baseQuery then read the file with the documentId
-            let ReadResponse; // Read Response Holder
-            if (((_a = this.baseQuery) === null || _a === void 0 ? void 0 : _a.documentId) !== undefined) {
-                const FilePath = [
-                    `${this.baseQuery.documentId}${Keys_1.General.DBMS_File_EXT}`,
-                ];
-                ReadResponse = yield this.LoadAllBufferRawData(FilePath);
-            }
-            else {
-                const fileNames = yield new ReadIndex_service_1.ReadIndex(this.path).getFileFromIndex(this.baseQuery);
-                if (fileNames.length > 0) {
-                    // Load File Names from Index
-                    ReadResponse = yield this.LoadAllBufferRawData(fileNames);
+            const lockManager = new LockManager_service_1.default(this.path);
+            const operationId = (0, crypto_1.randomUUID)();
+            const timestamp = Date.now();
+            let documentId = null;
+            try {
+                // STEP 1: Find the document first
+                let ReadResponse; // Read Response Holder
+                if (((_a = this.baseQuery) === null || _a === void 0 ? void 0 : _a.documentId) !== undefined) {
+                    const FilePath = [
+                        `${this.baseQuery.documentId}${Keys_1.General.DBMS_File_EXT}`,
+                    ];
+                    ReadResponse = yield this.LoadAllBufferRawData(FilePath);
                 }
                 else {
-                    ReadResponse = yield this.LoadAllBufferRawData();
+                    const fileNames = yield new ReadIndex_service_1.ReadIndex(this.path).getFileFromIndex(this.baseQuery);
+                    if (fileNames.length > 0) {
+                        // Load File Names from Index
+                        ReadResponse = yield this.LoadAllBufferRawData(fileNames);
+                    }
+                    else {
+                        ReadResponse = yield this.LoadAllBufferRawData();
+                    }
+                }
+                if (!("data" in ReadResponse)) {
+                    return this.ResponseHelper.Error(ReadResponse);
                 }
-            }
-            if ("data" in ReadResponse) {
                 const SearchedData = yield new Searcher_utils_1.default(ReadResponse.data, true).find(this.baseQuery, "data");
                 if (SearchedData.length === 0) {
                     return this.ResponseHelper.Error("No data found with the specified query");
@@ -94,91 +105,113 @@ class DeleteOperation {
                 let selectedFirstData = SearchedData[0]; // Select the first data
                 let fileName = selectedFirstData === null || selectedFirstData === void 0 ? void 0 : selectedFirstData.fileName; // Get the file name
                 // Sort the data if sort is provided then select the first data for deletion
-                if (Object.keys(this.sort).length === 0) {
-                    selectedFirstData = SearchedData[0]; // Select the first data
-                    fileName = selectedFirstData === null || selectedFirstData === void 0 ? void 0 : selectedFirstData.fileName; // Get the file name
-                }
-                else {
+                if (Object.keys(this.sort).length !== 0) {
                     const Sorter = new SortData_utils_1.default(SearchedData, this.sort);
                     const SortedData = yield Sorter.sort("data"); // Sort the data
                     selectedFirstData = SortedData[0]; // Select the first data
                     fileName = selectedFirstData === null || selectedFirstData === void 0 ? void 0 : selectedFirstData.fileName; // Get the file name
                 }
-                // Delete the file
-                const deleteResponse = yield this.deleteFile(fileName);
-                if ("data" in deleteResponse) {
-                    // Fire-and-forget: Remove from indexes and invalidate cache asynchronously for faster response
-                    const documentId = fileName.split('.')[0];
-                    new DeleteIndex_service_1.default(this.path).RemoveFromIndex(documentId, selectedFirstData === null || selectedFirstData === void 0 ? void 0 : selectedFirstData.data).catch(() => { });
-                    memory_operation_1.default.invalidateByDocument(this.path, documentId).catch(() => { });
-                    return this.ResponseHelper.Success({
-                        message: "Data deleted successfully",
-                        deleteData: selectedFirstData === null || selectedFirstData === void 0 ? void 0 : selectedFirstData.data,
-                    });
+                documentId = fileName.split('.')[0];
+                // STEP 2: Acquire lock on the document (ACID: Isolation)
+                const lockResult = yield lockManager.acquireLock(documentId, operationId, timestamp);
+                if (!("data" in lockResult)) {
+                    return this.ResponseHelper.Error("Lock acquisition failed");
                 }
-                else {
+                // STEP 3: Delete the file (now safe - locked)
+                const deleteResponse = yield this.deleteFile(fileName);
+                if (!("data" in deleteResponse)) {
                     return this.ResponseHelper.Error("Failed to delete data");
                 }
+                // Fire-and-forget: Remove from indexes and invalidate cache asynchronously for faster response
+                new DeleteIndex_service_1.default(this.path).RemoveFromIndex(documentId, selectedFirstData === null || selectedFirstData === void 0 ? void 0 : selectedFirstData.data).catch(() => { });
+                memory_operation_1.default.invalidateByDocument(this.path, documentId).catch(() => { });
+                return this.ResponseHelper.Success({
+                    message: "Data deleted successfully",
+                    deleteData: selectedFirstData === null || selectedFirstData === void 0 ? void 0 : selectedFirstData.data,
+                });
             }
-            else {
-                return this.ResponseHelper.Error(ReadResponse);
+            finally {
+                // STEP 4: Always release lock (ACID: ensures no deadlock)
+                if (documentId) {
+                    yield lockManager.releaseLock(documentId).catch(() => { });
+                }
             }
         });
     }
     /**
      * Deletes multiple documents that match the base query.
      *
-     * This method:
+     * This method with ACID compliance:
      * 1. Searches for documents matching the base query
-     * 2. Deletes each matching file
-     * 3. Returns success with the deleted data or an error
+     * 2. Acquires locks on ALL matching documents (ensures atomicity)
+     * 3. Deletes each matching file
+     * 4. Releases all locks
+     * 5. Returns success with the deleted data or an error
      *
      * @returns {Promise<SuccessInterface | ErrorInterface>} A promise that resolves to either:
      *   - Success with a success message and the deleted data
      *   - Error if:
      *     - No matching data is found
+     *     - Lock acquisition fails
      *     - Any file deletion operation fails
      *     - The initial buffer data loading fails
      */
     deleteMany() {
         return __awaiter(this, void 0, void 0, function* () {
-            let response;
-            const fileNames = yield new ReadIndex_service_1.ReadIndex(this.path).getFileFromIndex(this.baseQuery);
-            if (fileNames.length > 0) {
-                // Load File Names from Index
-                response = yield this.LoadAllBufferRawData(fileNames);
-            }
-            else {
-                response = yield this.LoadAllBufferRawData();
-            }
-            if ("data" in response) {
+            const lockManager = new LockManager_service_1.default(this.path);
+            const operationId = (0, crypto_1.randomUUID)();
+            const timestamp = Date.now();
+            const acquiredLocks = [];
+            try {
+                // STEP 1: Find all matching documents
+                let response;
+                const fileNames = yield new ReadIndex_service_1.ReadIndex(this.path).getFileFromIndex(this.baseQuery);
+                if (fileNames.length > 0) {
+                    // Load File Names from Index
+                    response = yield this.LoadAllBufferRawData(fileNames);
+                }
+                else {
+                    response = yield this.LoadAllBufferRawData();
+                }
+                if (!("data" in response)) {
+                    return this.ResponseHelper.Error(response);
+                }
                 const SearchedData = yield new Searcher_utils_1.default(response.data, true).find(this.baseQuery, "data");
                 if (SearchedData.length === 0) {
                     return this.ResponseHelper.Error("No data found with the specified query");
                 }
-                // Delete all files - fire index removal async for speed
+                // STEP 2: Extract all document IDs and acquire locks on ALL documents
+                const documentIds = SearchedData.map((data) => data.fileName.split('.')[0]);
+                for (const docId of documentIds) {
+                    const lockResult = yield lockManager.acquireLock(docId, operationId, timestamp);
+                    if (!("data" in lockResult)) {
+                        // Lock acquisition failed - rollback
+                        return this.ResponseHelper.Error(`Lock acquisition failed for document ${docId}`);
+                    }
+                    acquiredLocks.push(docId);
+                }
+                // STEP 3: All locks acquired - now perform deletions safely
                 const deleteIndexService = new DeleteIndex_service_1.default(this.path);
                 for (let i = 0; i < SearchedData.length; i++) {
                     const deleteResponse = yield this.deleteFile(SearchedData[i].fileName);
-                    if ("data" in deleteResponse) {
-                        // Fire-and-forget: Remove from indexes asynchronously
-                        deleteIndexService.RemoveFromIndex(SearchedData[i].fileName.split('.')[0], SearchedData[i].data).catch(() => { });
-                        continue;
-                    }
-                    else {
+                    if (!("data" in deleteResponse)) {
                         return this.ResponseHelper.Error("Failed to delete data");
                     }
+                    // Fire-and-forget: Remove from indexes asynchronously
+                    deleteIndexService.RemoveFromIndex(SearchedData[i].fileName.split('.')[0], SearchedData[i].data).catch(() => { });
                 }
                 // Fire-and-forget: Invalidate cache asynchronously
-                const documentIds = SearchedData.map((data) => data.fileName.split('.')[0]);
                 memory_operation_1.default.invalidateByDocuments(this.path, documentIds).catch(() => { });
                 return this.ResponseHelper.Success({
                     message: "Data deleted successfully",
                     deleteData: SearchedData.map((data) => data.data),
                 });
             }
-            else {
-                return this.ResponseHelper.Error(response);
+            finally {
+                // STEP 4: Always release ALL acquired locks (ACID: ensures no deadlock)
+                if (acquiredLocks.length > 0) {
+                    yield lockManager.releaseAllLocks(acquiredLocks).catch(() => { });
+                }
             }
         });
     }

package/lib/Services/CRUD Operation/Delete.operation.js.map

@@ -1 +1 @@
-{"version":3,"file":"Delete.operation.js","sourceRoot":"","sources":["../../../source/Services/CRUD Operation/Delete.operation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Delete.operation.js","sourceRoot":"","sources":["../../../source/Services/CRUD Operation/Delete.operation.ts"],"names":[],"mappings":"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"}

package/lib/Services/CRUD Operation/Update.operation.d.ts

@@ -17,31 +17,35 @@ export default class UpdateOperation {
     /**
      * Updates a single document that matches the base query.
      *
-     * This method performs the following operations:
-     * 1. Searches for documents matching the base query
-     * 2. If documents are found, selects the first document (or first after sorting if sort criteria are provided)
-     * 3. Deletes the existing document file
-     * 4. Inserts a new file with updated data using the same document ID
+     * This method performs the following operations with ACID compliance:
+     * 1. Acquires lock on document to ensure atomicity and isolation
+     * 2. Searches for documents matching the base query
+     * 3. If documents are found, selects the first document (or first after sorting if sort criteria are provided)
+     * 4. Deletes the existing document file
+     * 5. Inserts a new file with updated data using the same document ID
+     * 6. Releases lock
      *
      * @param newData - The new data to replace the existing document
      * @returns A Promise resolving to:
      *          - Success with updated data and previous data if successful
-     *          - Error if any step fails
+     *          - Error if any step fails (lock acquisition, read, update)
      * @throws May throw errors during file operations or data processing
      */
     UpdateOne(newData: object | any): Promise<SuccessInterface | ErrorInterface>;
     /**
      * Updates multiple documents that match the base query.
      *
-     * This method performs the following operations:
+     * This method performs the following operations with ACID compliance:
      * 1. Searches for documents matching the base query
-     * 2. Deletes the existing documents
-     * 3. Inserts new files with updated data for each document
+     * 2. Acquires locks on ALL matching documents (ensures atomicity across all updates)
+     * 3. Deletes the existing documents
+     * 4. Inserts new files with updated data for each document
+     * 5. Releases all locks
      *
      * @param newData - The new data to replace the existing documents
      * @returns A Promise resolving to:
      *          - Success with updated data and previous data if successful
-     *          - Error if any step fails
+     *          - Error if any step fails (rollback by releasing all acquired locks)
      * @throws May throw errors during file operations or data processing
      */
     UpdateMany(newData: object | any): Promise<SuccessInterface | ErrorInterface>;