axiodb 14.2.7 → 15.0.0

package/lib/server/controller/Database/Databse.controller.js

@@ -50,8 +50,11 @@ const StatusCode_1 = require("../../../config/Keys/StatusCode");
 const responseBuilder_helper_1 = __importDefault(require("../../helper/responseBuilder.helper"));
 const ZipUnzip_utils_1 = require("../../../utility/ZipUnzip.utils");
 const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
+const promises_1 = require("node:stream/promises");
 const Permissions_1 = require("../../../config/Keys/Permissions");
+const databaseImport_helper_1 = require("../../helper/databaseImport.helper");
 class DatabaseController {
     constructor(AxioDBInstance) {
         this.AxioDBInstance = AxioDBInstance;
@@ -180,35 +183,140 @@ class DatabaseController {
             }
         });
     }
+    /**
+     * Imports a database from an uploaded .tar.gz.
+     *
+     * Everything is staged outside the data directory and proven to be a genuine AxioDB
+     * export before a single byte is promoted into place. That ordering is what lets a bad
+     * upload be discarded completely: an archive that fails validation never existed as far
+     * as the live data directory is concerned, so there is no partial database to clean up.
+     */
     importDatabase(request, reply) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            var _b;
+            const username = (_b = (_a = request.authUser) === null || _a === void 0 ? void 0 : _a.username) !== null && _b !== void 0 ? _b : "another user";
             const data = yield request.file();
             if (!data) {
-                return reply.status(400).send({
-                    success: false,
-                    message: "No file uploaded",
-                });
+                return reply.status(400).send({ success: false, message: "No file uploaded" });
             }
-            const uploadedArchiveName = path_1.default.parse(data.filename).name;
+            // A cheap pre-check on the filename. The authoritative check is on the archive's
+            // contents further down - a file can be named anything.
+            const uploadedArchiveName = path_1.default
+                .basename(data.filename)
+                .replace(/\.(tar\.gz|tgz|tar|gz|zip)$/i, "");
             if ((0, Permissions_1.isReservedDatabaseName)(uploadedArchiveName)) {
                 return reply.status(403).send({
                     success: false,
                     message: "This is a reserved system database",
                 });
             }
-            const tempDir = path_1.default.join(__dirname, "uploads");
-            yield fs_1.default.promises.mkdir(tempDir, { recursive: true });
-            const savePath = path_1.default.join(tempDir, data.filename);
-            yield fs_1.default.promises.writeFile(savePath, yield data.toBuffer());
-            const unzipped = yield (0, ZipUnzip_utils_1.unzipFile)(savePath, this.AxioDBInstance.GetPath);
-            if (!unzipped) {
+            // Every import gets its own staging directory, so two people importing different
+            // databases at the same time never share state.
+            const workDir = yield fs_1.default.promises.mkdtemp(path_1.default.join(os_1.default.tmpdir(), "axiodb-import-"));
+            const stagingDir = path_1.default.join(workDir, "extracted");
+            yield fs_1.default.promises.mkdir(stagingDir);
+            let claimed = null;
+            try {
+                // Only the basename is used, so a crafted "../../" filename cannot escape workDir.
+                const savePath = path_1.default.join(workDir, path_1.default.basename(data.filename));
+                yield (0, promises_1.pipeline)(data.file, fs_1.default.createWriteStream(savePath));
+                if (data.file.truncated) {
+                    return reply.status(413).send({
+                        success: false,
+                        message: "Upload was truncated before it finished.",
+                    });
+                }
+                try {
+                    // Extracted into staging, never straight into the data directory.
+                    yield (0, ZipUnzip_utils_1.unzipFile)(savePath, stagingDir);
+                }
+                catch (error) {
+                    console.error("Error unzipping uploaded database:", error);
+                    return reply.status(400).send({
+                        success: false,
+                        message: error instanceof ZipUnzip_utils_1.UnsafeArchiveError
+                            ? error.message
+                            : "Could not read that file as a .tar.gz archive. Upload the file produced by Export.",
+                    });
+                }
+                // The database name comes from the archive's contents, not its filename: the same
+                // export can arrive under any name, and two names can hold the same database.
+                let databaseName;
+                try {
+                    databaseName = (0, databaseImport_helper_1.readExportedDatabaseName)(stagingDir);
+                }
+                catch (error) {
+                    console.error("Rejected upload that is not an AxioDB export:", error);
+                    return reply.status(400).send({
+                        success: false,
+                        message: error instanceof databaseImport_helper_1.InvalidExportError
+                            ? error.message
+                            : "That file is not an AxioDB database export.",
+                    });
+                }
+                if ((0, Permissions_1.isReservedDatabaseName)(databaseName)) {
+                    return reply.status(403).send({
+                        success: false,
+                        message: `"${databaseName}" is a reserved system database`,
+                    });
+                }
+                // Claim before touching the destination, so a second importer of the same database is
+                // turned away rather than racing this one into the same directory.
+                try {
+                    (0, databaseImport_helper_1.claimImport)(databaseName, username);
+                    claimed = databaseName;
+                }
+                catch (error) {
+                    return reply.status(409).send({
+                        success: false,
+                        message: error instanceof databaseImport_helper_1.ImportConflictError
+                            ? error.message
+                            : "That database is already being imported.",
+                    });
+                }
+                const destination = path_1.default.join(this.AxioDBInstance.GetPath, databaseName);
+                if (fs_1.default.existsSync(destination)) {
+                    return reply.status(409).send({
+                        success: false,
+                        message: `"${databaseName}" already exists on this instance. Delete it first if you want to replace it.`,
+                    });
+                }
+                const source = path_1.default.join(stagingDir, databaseName);
+                try {
+                    yield fs_1.default.promises.rename(source, destination);
+                }
+                catch (error) {
+                    // Staging lives in the OS temp directory, which is frequently a different
+                    // filesystem - rename cannot cross one, so fall back to a copy.
+                    if ((error === null || error === void 0 ? void 0 : error.code) !== "EXDEV")
+                        throw error;
+                    yield fs_1.default.promises.cp(source, destination, { recursive: true });
+                }
+                return {
+                    message: "Database imported successfully",
+                    database: databaseName,
+                    file: data.filename,
+                };
+            }
+            catch (error) {
+                console.error("Error importing database:", error);
                 return reply.status(500).send({
                     success: false,
-                    message: "Error unzipping file",
+                    message: "Error importing database",
+                });
+            }
+            finally {
+                if (claimed !== null)
+                    (0, databaseImport_helper_1.releaseImport)(claimed);
+                // Discards the upload and everything extracted from it, on every path - success,
+                // rejection, or crash. Nothing an invalid archive produced survives this.
+                yield fs_1.default.promises
+                    .rm(workDir, { recursive: true, force: true })
+                    .catch((cleanupError) => {
+                    console.error("Error cleaning up import staging directory:", cleanupError);
                 });
             }
-            yield fs_1.default.promises.rmdir(tempDir, { recursive: true });
-            return { message: "File uploaded successfully", file: data.filename };
         });
     }
 }

package/lib/server/controller/Database/Databse.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"Databse.controller.js","sourceRoot":"","sources":["../../../../source/server/controller/Database/Databse.controller.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Databse.controller.js","sourceRoot":"","sources":["../../../../source/server/controller/Database/Databse.controller.ts"],"names":[],"mappings":"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"}

package/lib/server/helper/databaseImport.helper.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Import staging: validating an uploaded archive before any of it reaches the live data
+ * directory, and serialising concurrent imports of the same database.
+ */
+/** Thrown when an upload is not a genuine AxioDB export. Callers answer 400. */
+export declare class InvalidExportError extends Error {
+    constructor(message: string);
+}
+/** Thrown when the same database is already present or already being imported. Answer 409. */
+export declare class ImportConflictError extends Error {
+    constructor(message: string);
+}
+/**
+ * Confirms that a staged directory holds one AxioDB database export, and returns its name.
+ *
+ * The database name comes from the archive's own contents, never from the uploaded
+ * filename - two people can export the same database and rename the file to anything, so
+ * the filename says nothing about what is inside.
+ *
+ * `tarGzFolder` archives `{root}/{dbName}`, so a genuine export is exactly one top-level
+ * directory containing recognisable AxioDB artefacts.
+ *
+ * @param stagingDir - Directory the archive was extracted into.
+ * @returns The database name the archive contains.
+ * @throws {InvalidExportError} When the contents are not an AxioDB export.
+ */
+export declare function readExportedDatabaseName(stagingDir: string): string;
+/**
+ * Claims the right to import `databaseName`.
+ *
+ * @param databaseName - Name read from the archive's contents.
+ * @param username - Who is importing, so a clash can name them.
+ * @throws {ImportConflictError} When another import of the same database is in flight.
+ */
+export declare function claimImport(databaseName: string, username: string): void;
+/** Releases the claim. Always call from a `finally`. */
+export declare function releaseImport(databaseName: string): void;

package/lib/server/helper/databaseImport.helper.js

@@ -0,0 +1,120 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportConflictError = exports.InvalidExportError = void 0;
+exports.readExportedDatabaseName = readExportedDatabaseName;
+exports.claimImport = claimImport;
+exports.releaseImport = releaseImport;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const Keys_1 = require("../../config/Keys/Keys");
+/**
+ * Import staging: validating an uploaded archive before any of it reaches the live data
+ * directory, and serialising concurrent imports of the same database.
+ */
+/** Thrown when an upload is not a genuine AxioDB export. Callers answer 400. */
+class InvalidExportError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InvalidExportError";
+    }
+}
+exports.InvalidExportError = InvalidExportError;
+/** Thrown when the same database is already present or already being imported. Answer 409. */
+class ImportConflictError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ImportConflictError";
+    }
+}
+exports.ImportConflictError = ImportConflictError;
+/**
+ * Confirms that a staged directory holds one AxioDB database export, and returns its name.
+ *
+ * The database name comes from the archive's own contents, never from the uploaded
+ * filename - two people can export the same database and rename the file to anything, so
+ * the filename says nothing about what is inside.
+ *
+ * `tarGzFolder` archives `{root}/{dbName}`, so a genuine export is exactly one top-level
+ * directory containing recognisable AxioDB artefacts.
+ *
+ * @param stagingDir - Directory the archive was extracted into.
+ * @returns The database name the archive contains.
+ * @throws {InvalidExportError} When the contents are not an AxioDB export.
+ */
+function readExportedDatabaseName(stagingDir) {
+    const entries = fs_1.default.readdirSync(stagingDir, { withFileTypes: true });
+    const directories = entries.filter((entry) => entry.isDirectory());
+    const strayFiles = entries.filter((entry) => !entry.isDirectory());
+    if (directories.length === 0) {
+        throw new InvalidExportError("That archive contains no database folder. Upload the file produced by Export.");
+    }
+    if (directories.length > 1 || strayFiles.length > 0) {
+        throw new InvalidExportError("That archive holds more than one top-level item. An AxioDB export contains exactly one database folder.");
+    }
+    const databaseName = directories[0].name;
+    const databaseDir = path_1.default.join(stagingDir, databaseName);
+    if (!/^[a-zA-Z0-9_-]+$/.test(databaseName)) {
+        throw new InvalidExportError(`"${databaseName}" is not a usable database name.`);
+    }
+    // Allowlist rather than a presence check: a database that has no collections yet is a
+    // legitimate export and contains nothing at all, so "must contain X" would reject it.
+    // Asking instead that it contain *nothing but* AxioDB shapes accepts the empty case while
+    // still rejecting a folder of holiday photos.
+    for (const entry of fs_1.default.readdirSync(databaseDir, { withFileTypes: true })) {
+        if (entry.isFile()) {
+            if (entry.name !== Keys_1.General.Collection_Meta_File) {
+                throw new InvalidExportError(`"${databaseName}" is not an AxioDB export - it contains an unexpected file "${entry.name}".`);
+            }
+            continue;
+        }
+        if (!entry.isDirectory()) {
+            throw new InvalidExportError(`"${databaseName}" contains "${entry.name}", which is neither a file nor a collection folder.`);
+        }
+        // Each subdirectory must look like a collection: documents, indexes, or WAL, and
+        // nothing else. An empty collection folder is fine.
+        const collectionDir = path_1.default.join(databaseDir, entry.name);
+        for (const child of fs_1.default.readdirSync(collectionDir, { withFileTypes: true })) {
+            const isDocument = child.isFile() && child.name.endsWith(Keys_1.General.DBMS_File_EXT);
+            const isInternalDir = child.isDirectory() && (child.name === "indexes" || child.name === ".transactions");
+            if (!isDocument && !isInternalDir) {
+                throw new InvalidExportError(`"${databaseName}/${entry.name}" is not an AxioDB collection - it contains "${child.name}".`);
+            }
+        }
+    }
+    return databaseName;
+}
+/**
+ * In-process registry of imports currently in flight, keyed by database name.
+ *
+ * Two people importing *different* databases run concurrently and never meet - each gets
+ * its own staging directory. Two people importing the *same* database must not, because
+ * both would write the same destination: the second is told who has it instead.
+ *
+ * A Map is sufficient because AxioDB is a hard singleton - one process owns the data
+ * directory, so there is no second server to coordinate with.
+ */
+const activeImports = new Map();
+/**
+ * Claims the right to import `databaseName`.
+ *
+ * @param databaseName - Name read from the archive's contents.
+ * @param username - Who is importing, so a clash can name them.
+ * @throws {ImportConflictError} When another import of the same database is in flight.
+ */
+function claimImport(databaseName, username) {
+    const holder = activeImports.get(databaseName);
+    if (holder !== undefined) {
+        throw new ImportConflictError(holder === username
+            ? `You already have an import of "${databaseName}" running.`
+            : `"${databaseName}" is currently being imported by ${holder}. Try again once that finishes.`);
+    }
+    activeImports.set(databaseName, username);
+}
+/** Releases the claim. Always call from a `finally`. */
+function releaseImport(databaseName) {
+    activeImports.delete(databaseName);
+}
+//# sourceMappingURL=databaseImport.helper.js.map

package/lib/server/helper/databaseImport.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseImport.helper.js","sourceRoot":"","sources":["../../../source/server/helper/databaseImport.helper.ts"],"names":[],"mappings":"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"}

package/lib/server/helper/documentCounterInFolder.helper.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Counts the real documents stored directly in a collection folder.
+ *
+ * Documents are flat `.axiodb` files in the collection root. Everything else
+ * that lives there - the `indexes/` folder, `.transactions/` WAL staging, meta
+ * files - is internal bookkeeping and must not be counted, which is why this is
+ * neither recursive nor extension-agnostic.
+ *
+ * @param folderPath - Absolute path to the collection folder.
+ * @returns Number of documents in that collection.
+ */
+export default function countDocumentsInFolder(folderPath: string): Promise<number>;

package/lib/server/helper/{filesCounterInFolder.helper.js → documentCounterInFolder.helper.js}

@@ -12,23 +12,24 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = countFilesRecursive;
+exports.default = countDocumentsInFolder;
 const promises_1 = __importDefault(require("node:fs/promises"));
-const node_path_1 = __importDefault(require("node:path"));
-function countFilesRecursive(folderPath) {
+const Keys_1 = require("../../config/Keys/Keys");
+/**
+ * Counts the real documents stored directly in a collection folder.
+ *
+ * Documents are flat `.axiodb` files in the collection root. Everything else
+ * that lives there - the `indexes/` folder, `.transactions/` WAL staging, meta
+ * files - is internal bookkeeping and must not be counted, which is why this is
+ * neither recursive nor extension-agnostic.
+ *
+ * @param folderPath - Absolute path to the collection folder.
+ * @returns Number of documents in that collection.
+ */
+function countDocumentsInFolder(folderPath) {
     return __awaiter(this, void 0, void 0, function* () {
-        let count = 0;
         const items = yield promises_1.default.readdir(folderPath, { withFileTypes: true });
-        for (const item of items) {
-            const fullPath = node_path_1.default.join(folderPath, item.name);
-            if (item.isFile()) {
-                count++;
-            }
-            else if (item.isDirectory()) {
-                count += yield countFilesRecursive(fullPath);
-            }
-        }
-        return count;
+        return items.filter((item) => item.isFile() && item.name.endsWith(Keys_1.General.DBMS_File_EXT)).length;
     });
 }
-//# sourceMappingURL=filesCounterInFolder.helper.js.map
+//# sourceMappingURL=documentCounterInFolder.helper.js.map

package/lib/server/helper/documentCounterInFolder.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentCounterInFolder.helper.js","sourceRoot":"","sources":["../../../source/server/helper/documentCounterInFolder.helper.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,gEAAkC;AAClC,iDAAiD;AAEjD;;;;;;;;;;GAUG;AACH,gCACE,UAAkB;;QAElB,MAAM,KAAK,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,OAAO,KAAK,CAAC,MAAM,CACjB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAO,CAAC,aAAa,CAAC,CACrE,CAAC,MAAM,CAAC;IACX,CAAC;CAAA"}

package/lib/server/public/AxioControl/.vite/manifest.json

@@ -1,11 +1,11 @@
 {
   "index.html": {
-    "file": "assets/index-Ddne1B8d.js",
+    "file": "assets/index-DkwtNvzk.js",
     "name": "index",
     "src": "index.html",
     "isEntry": true,
     "css": [
-      "assets/index-05O5admf.css"
+      "assets/index-DwPXIyl2.css"
     ]
   }
 }