axiodb 22.10.8 → 22.13.1

package/README.md

@@ -139,14 +139,14 @@ supported.
 * **Zero native deps** — pure JS, no `node-gyp`, no `electron-rebuild`
 * **MongoDB-style queries** — `{ age: { $gt: 25 } }`, 19 operators + `hint()` + `findByIds()`
 * **ACID transactions** — `savepoint`/`rollbackTo`/`WAL`, crashes recover via `Transaction.recoverTransactions()`
-* **Aggregation** — 60+ stages, `$lookup` joins, `OperatorRegistry` custom ops
+* **Aggregation** — 19 stages, `$lookup` joins, `OperatorRegistry` custom ops
 * **InMemoryCache + indexes** — per-instance cache, dual-write, auto `IndexCache`
 * **Configurable cache** — `{ Cache, minTTL, maxTTL, cacheClearUp }` controls the per-instance InMemoryCache (default `5–15m` randomized TTL, `Cache: false` disables it) → [axiodb.in/api-reference](https://axiodb.in/api-reference)
 * **Ports:** GUI `27018` · TCP `27019` `AxioDBCloud` · MCP `27020` Docker-only
 
 > **Docs:** `axiodb.in` is the single source — this README is a quick start only.
 
-* **AxioDBCloud (TCP)** — remote `AxioDBCloud` client, 32 commands, optional `TCPAuth` + `TLS` → [axiodb.in/cloud](https://axiodb.in/cloud)
+* **AxioDBCloud (TCP)** — remote `AxioDBCloud` client, 30 commands, optional `TCPAuth` + `TLS` → [axiodb.in/cloud](https://axiodb.in/cloud)
 * **CLI (Go)** — `axiodb document insert/query` `--hint` `find-by-ids` `transaction begin/commit` `user change-password` (HTTP `27018` for management, TCP `27019` for data) → [axiodb.in/cli](https://axiodb.in/cli)
 * **Docker** — `theankansaha/axiodb` `AXIODB_GUI/TCP/MCP` `27018/27019/27020` → [axiodb.in/docker](https://axiodb.in/docker)
 * **MCP Server** — 43 tools `axiodb_login` → `sessionId` + `withConfirmation` `Docker/mcp/tools/*.js` → [axiodb.in/mcp-server](https://axiodb.in/mcp-server)

package/lib/Services/Indexation.operation.js

@@ -20,7 +20,6 @@ const Keys_1 = require("../config/Keys/Keys");
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const database_operation_1 = __importDefault(require("./Database/database.operation"));
-// import startWebServer from "../server/Fastify";
 // Helper Classes
 const Converter_helper_1 = __importDefault(require("../Helper/Converter.helper"));
 const Console_helper_1 = __importDefault(require("../Helper/Console.helper"));

package/lib/config/Keys/Keys.d.ts

@@ -9,10 +9,3 @@ export declare const General: {
     WAL_File_EXT: string;
     DocumentId_Length: number;
 };
-export declare enum WebServer {
-    StaticServerPORT = 2025,
-    ApiServerPORT = 2026,
-    TCPServerPORT = 2027,
-    WebSocketServerPORT = 2028,
-    GraphQLServerPORT = 2029
-}

package/lib/config/Keys/Keys.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WebServer = exports.General = void 0;
+exports.General = void 0;
 exports.General = {
     DBMS_Name: "AxioDB",
     DBMS_GUI_Enable: false,
@@ -12,11 +12,3 @@ exports.General = {
     WAL_File_EXT: ".wal.jsonl",
     DocumentId_Length: 30, // Length of auto-generated alphanumeric document IDs
 };
-var WebServer;
-(function (WebServer) {
-    WebServer[WebServer["StaticServerPORT"] = 2025] = "StaticServerPORT";
-    WebServer[WebServer["ApiServerPORT"] = 2026] = "ApiServerPORT";
-    WebServer[WebServer["TCPServerPORT"] = 2027] = "TCPServerPORT";
-    WebServer[WebServer["WebSocketServerPORT"] = 2028] = "WebSocketServerPORT";
-    WebServer[WebServer["GraphQLServerPORT"] = 2029] = "GraphQLServerPORT";
-})(WebServer || (exports.WebServer = WebServer = {}));

package/lib/engine/cli/worker_process.d.ts

@@ -0,0 +1,19 @@
+export default class WorkerProcess {
+    /**
+     * Executes a binary with explicit arguments without a shell, capturing stdout.
+     *
+     * No shell string is ever constructed, so filenames or paths containing shell
+     * metacharacters cannot inject extra commands. Always prefer this over building
+     * a shell command when arguments derive from user-controlled paths.
+     *
+     * @param command - The executable to run (e.g. "du", "wc", "powershell").
+     * @param args - Arguments passed verbatim; no quoting or interpolation is applied.
+     * @returns The command's captured stdout.
+     * @example
+     * const size = await worker.execCommandSafely("wc", ["-c", "--", targetPath]);
+     */
+    execCommandSafely(command: string, args?: string[]): Promise<string>;
+    /** Inherits stdio; rejects if the process exits with a non-zero code. */
+    spawnCommand(command: string, args?: string[]): Promise<void>;
+    static getOS(): string;
+}

package/lib/engine/cli/worker_process.js

@@ -0,0 +1,92 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+class WorkerProcess {
+    /**
+     * Executes a binary with explicit arguments without a shell, capturing stdout.
+     *
+     * No shell string is ever constructed, so filenames or paths containing shell
+     * metacharacters cannot inject extra commands. Always prefer this over building
+     * a shell command when arguments derive from user-controlled paths.
+     *
+     * @param command - The executable to run (e.g. "du", "wc", "powershell").
+     * @param args - Arguments passed verbatim; no quoting or interpolation is applied.
+     * @returns The command's captured stdout.
+     * @example
+     * const size = await worker.execCommandSafely("wc", ["-c", "--", targetPath]);
+     */
+    execCommandSafely(command_1) {
+        return __awaiter(this, arguments, void 0, function* (command, args = []) {
+            try {
+                const stdout = yield new Promise((resolve, reject) => {
+                    const child = (0, child_process_1.spawn)(command, args, { shell: false });
+                    let out = "";
+                    let err = "";
+                    child.stdout.on("data", (chunk) => {
+                        out += chunk.toString();
+                    });
+                    child.stderr.on("data", (chunk) => {
+                        err += chunk.toString();
+                    });
+                    child.on("error", reject);
+                    child.on("close", (code) => {
+                        if (code === 0) {
+                            resolve(out);
+                        }
+                        else {
+                            reject(new Error(`Command failed with exit code ${code}${err ? `: ${err.trim()}` : ""}`));
+                        }
+                    });
+                });
+                return stdout;
+            }
+            catch (error) {
+                throw new Error(`Failed to execute command: ${error}`);
+            }
+        });
+    }
+    /** Inherits stdio; rejects if the process exits with a non-zero code. */
+    spawnCommand(command_1) {
+        return __awaiter(this, arguments, void 0, function* (command, args = []) {
+            try {
+                const child = (0, child_process_1.spawn)(command, args, { stdio: "inherit" });
+                return new Promise((resolve, reject) => {
+                    child.on("close", (code) => {
+                        if (code !== 0) {
+                            reject(new Error(`Command failed with exit code ${code}`));
+                        }
+                        else {
+                            resolve();
+                        }
+                    });
+                });
+            }
+            catch (error) {
+                throw new Error(`Failed to spawn command: ${error}`);
+            }
+        });
+    }
+    static getOS() {
+        const platform = process.platform;
+        if (platform === "win32") {
+            return "windows";
+        }
+        if (platform === "darwin") {
+            return "macos";
+        }
+        if (platform === "linux") {
+            return "linux";
+        }
+        throw new Error(`Unsupported platform: ${platform}`);
+    }
+}
+exports.default = WorkerProcess;

package/lib/server/config/keys.d.ts

@@ -1,6 +1,6 @@
 export declare enum ServerKeys {
     PORT = 27018,
-    LOCALHOST = "127.0.1",
+    LOCALHOST = "127.0.0.1",
     DEFAULT_KEY_EXPIRE = "24h",
     DEFAULT_KEY_ISSUER = "AxioDB Server",
     DEFAULT_KEY_AUDIENCE = "AxioDB Client",

package/lib/server/config/keys.js

@@ -8,7 +8,7 @@ const path_1 = __importDefault(require("path"));
 var ServerKeys;
 (function (ServerKeys) {
     ServerKeys[ServerKeys["PORT"] = 27018] = "PORT";
-    ServerKeys["LOCALHOST"] = "127.0.1";
+    ServerKeys["LOCALHOST"] = "127.0.0.1";
     ServerKeys["DEFAULT_KEY_EXPIRE"] = "24h";
     ServerKeys["DEFAULT_KEY_ISSUER"] = "AxioDB Server";
     ServerKeys["DEFAULT_KEY_AUDIENCE"] = "AxioDB Client";
@@ -62,6 +62,16 @@ exports.AvailableRoutes = [
                 path: "/api/routes",
                 description: "List all available API routes",
             },
+            {
+                method: "GET",
+                path: "/api/system",
+                description: "Server runtime details: version, platform, CPU, memory, cache, and running services with their ports",
+            },
+            {
+                method: "GET",
+                path: "/api/dashboard-stats",
+                description: "Aggregated dashboard statistics for the GUI overview page",
+            },
         ],
     },
     {
@@ -179,6 +189,19 @@ exports.AvailableRoutes = [
                 description: "Get specific documents from a collection by ID",
                 path: "/api/operation/all/by-id/?dbName&collectionName&documentId",
             },
+            {
+                method: "GET",
+                description: "Get the total document count of a collection",
+                path: "/api/operation/total/?dbName&collectionName",
+            },
+            {
+                method: "POST",
+                description: "Get specific documents from a collection by a list of IDs",
+                path: "/api/operation/all/by-ids/?dbName&collectionName",
+                payload: {
+                    documentIds: "array",
+                },
+            },
             {
                 method: "POST",
                 description: "Create a new document in a collection",
@@ -311,6 +334,11 @@ exports.AvailableRoutes = [
                 path: "/api/auth/roles/permissions",
                 description: "List the full predefined permission catalogue",
             },
+            {
+                method: "DELETE",
+                path: "/api/auth/roles/:roleName",
+                description: "Delete a custom role",
+            },
         ],
     },
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "axiodb",
-  "version": "22.10.8",
+  "version": "22.13.1",
   "description": "The embedded database for Node.js. Replaces SQLite, LowDB, NeDB & raw JSON files with MongoDB-style queries, ACID transactions, zero native dependencies, and built-in InMemoryCache. No compilation, no platform issues. Perfect for desktop apps, CLI tools, and embedded systems.",
   "main": "./lib/config/DB.js",
   "types": "./lib/config/DB.d.ts",

package/electron/electron-builder.json

@@ -1,54 +0,0 @@
-{
-  "appId": "com.axiodb.control",
-  "productName": "AxioDB Control",
-  "copyright": "Copyright © 2026 Ankan Saha",
-  "directories": {
-    "output": "release",
-    "buildResources": "resources"
-  },
-  "files": [
-    "dist/**/*",
-    "dist-electron/**/*",
-    "resources/**/*",
-    "package.json"
-  ],
-  "extraResources": [
-    {
-      "from": "resources/icon.png",
-      "to": "icon.png"
-    }
-  ],
-  "linux": {
-    "target": [
-      { "target": "deb", "arch": ["x64", "arm64"] },
-      { "target": "AppImage", "arch": ["x64", "arm64"] }
-    ],
-    "maintainer": "Ankan Saha <dev@axiodb.in>",
-    "category": "Development",
-    "icon": "resources/icons",
-    "synopsis": "Desktop GUI management client for AxioDB",
-    "description": "Next-generation desktop interface for managing AxioDB databases, collections, documents, queries, and monitoring.",
-    "desktop": {
-      "StartupWMClass": "AxioDB Control"
-    }
-  },
-  "win": {
-    "target": [
-      { "target": "nsis", "arch": ["x64"] }
-    ],
-    "icon": "resources/icon.png"
-  },
-  "mac": {
-    "target": [
-      { "target": "zip", "arch": ["x64", "arm64"] }
-    ],
-    "category": "public.app-category.developer-tools",
-    "icon": "resources/icon.png"
-  },
-  "nsis": {
-    "oneClick": false,
-    "allowToChangeInstallationDirectory": true,
-    "createDesktopShortcut": true,
-    "createStartMenuShortcut": true
-  }
-}