axiodb 22.11.0 → 22.14.1

package/README.md

@@ -93,15 +93,39 @@ Set `CHOICE` before piping to select without the menu:
 curl -fsSL https://raw.githubusercontent.com/nexoral/AxioDB/main/cli/Scripts/install.sh | CHOICE=2 bash
 
 # GUI (Desktop app) — Windows
-irm https://raw.githubusercontent.com/nexoral/AxioDB/main/cli/Scripts/install.ps1 | CHOICE=2 iex
+$env:CHOICE=2; irm https://raw.githubusercontent.com/nexoral/AxioDB/main/cli/Scripts/install.ps1 | iex
 
-# Both CLI + GUI
+# Both CLI + GUI — Linux
 curl -fsSL https://raw.githubusercontent.com/nexoral/AxioDB/main/cli/Scripts/install.sh | CHOICE=3 bash
+
+# Both CLI + GUI — Windows
+$env:CHOICE=3; irm https://raw.githubusercontent.com/nexoral/AxioDB/main/cli/Scripts/install.ps1 | iex
 ```
 
 You can also download installers directly from
 [GitHub Releases](https://github.com/nexoral/AxioDB/releases).
 
+#### Start a temporary local server
+
+The CLI can start a disposable local AxioDB server for development. It installs
+the published `axiodb` npm package into a temporary directory, keeps the server
+attached to the terminal, and deletes its data when you press `Ctrl+C`.
+Node.js ≥20 and npm are required; the command offers platform-specific
+installation help when they are missing.
+
+```bash
+axiodb serve http       # HTTP API only: http://localhost:27018/api
+axiodb serve tcp        # TCP without authentication: axiodb://localhost:27019
+axiodb serve tcp-auth   # TCP authentication only
+axiodb serve full       # HTTP + authenticated TCP, GUI disabled
+```
+
+The HTTP and TCP ports are fixed at `27018` and `27019`. The `tcp-auth` preset
+seeds `admin/admin`, but the server requires the first password change through
+HTTP/GUI and TCP currently has no password-change command, so this preset is
+intended for inspecting the authentication server setup rather than immediate
+authenticated client access.
+
 
 ## Basic CRUD
 
@@ -139,14 +163,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/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.11.0",
+  "version": "22.14.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",