inibase 1.0.0-rc.4 → 1.0.0-rc.40

package/dist/index.js

@@ -0,0 +1,1106 @@
+import { unlink, rename, mkdir, readdir } from "node:fs/promises";
+import { existsSync, appendFileSync } from "node:fs";
+import { join } from "node:path";
+import { scryptSync, randomBytes } from "node:crypto";
+import { Worker } from "node:worker_threads";
+import File from "./file.js";
+import Utils from "./utils.js";
+import UtilsServer from "./utils.server.js";
+import Config from "./config.js";
+import { inspect } from "node:util";
+export default class Inibase {
+    folder;
+    database;
+    table;
+    pageInfo;
+    isThreadEnabled = false;
+    totalItems;
+    salt;
+    constructor(database, mainFolder = ".", _table = null, _totalItems = {}, _pageInfo = {}, _isThreadEnabled = false) {
+        this.database = database;
+        this.folder = mainFolder;
+        this.table = _table;
+        this.totalItems = _totalItems;
+        this.pageInfo = _pageInfo;
+        this.isThreadEnabled = _isThreadEnabled;
+        if (!existsSync(".env") || !process.env.INIBASE_SECRET) {
+            this.salt = scryptSync(randomBytes(16), randomBytes(16), 32);
+            appendFileSync(".env", `\nINIBASE_SECRET=${this.salt.toString("hex")}\n`);
+        }
+        else
+            this.salt = Buffer.from(process.env.INIBASE_SECRET, "hex");
+    }
+    throwError(code, variable, language = "en") {
+        const errorMessages = {
+            en: {
+                FIELD_REQUIRED: "Field {variable} is required",
+                NO_SCHEMA: "Table {variable} does't have a schema",
+                NO_ITEMS: "Table {variable} is empty",
+                NO_RESULTS: "No results found for table {variable}",
+                INVALID_ID: "The given ID(s) is/are not valid(s)",
+                INVALID_TYPE: "Expect {variable} to be {variable}, got {variable} instead",
+                INVALID_PARAMETERS: "The given parameters are not valid",
+            },
+            // Add more languages and error messages as needed
+        };
+        let errorMessage = errorMessages[language][code];
+        if (!errorMessage)
+            return new Error("ERR");
+        return new Error(variable
+            ? Array.isArray(variable)
+                ? errorMessage.replace(/\{variable\}/g, () => variable.shift()?.toString() ?? "")
+                : errorMessage.replaceAll(`{variable}`, `'${variable.toString()}'`)
+            : errorMessage.replaceAll(`{variable}`, ""));
+    }
+    async createWorker(functionName, arg) {
+        return new Promise((resolve, reject) => {
+            const worker = new Worker("./dist/index.thread.js", {
+                workerData: {
+                    _constructor: [
+                        this.database,
+                        this.folder,
+                        this.table,
+                        this.totalItems,
+                        this.pageInfo,
+                        true, // enable Thread
+                    ],
+                    functionName,
+                    arg,
+                },
+            });
+            worker.on("message", resolve);
+            worker.on("error", reject);
+        });
+    }
+    _decodeIdFromSchema = (schema) => schema.map((field) => {
+        if ((field.type === "array" || field.type === "object") &&
+            field.children &&
+            Utils.isArrayOfObjects(field.children))
+            field.children = this._decodeIdFromSchema(field.children);
+        if (field.id && !Utils.isNumber(field.id))
+            field.id = UtilsServer.decodeID(field.id, this.salt);
+        return field;
+    });
+    _schemaToIdsPath = (schema, prefix = "") => {
+        let RETURN = {};
+        for (const field of schema)
+            if ((field.type === "array" || field.type === "object") &&
+                field.children &&
+                Utils.isArrayOfObjects(field.children)) {
+                Utils.deepMerge(RETURN, this._schemaToIdsPath(field.children, (prefix ?? "") + field.key + "."));
+            }
+            else if (Utils.isValidID(field.id))
+                RETURN[UtilsServer.decodeID(field.id, this.salt)] =
+                    (prefix ?? "") + field.key + ".inib";
+        return RETURN;
+    };
+    async setTableSchema(tableName, schema) {
+        const tablePath = join(this.folder, this.database, tableName), tableSchemaPath = join(tablePath, "schema.json"), isTablePathExists = await File.isExists(tablePath);
+        // remove id from schema
+        schema = schema.filter(({ key }) => !["id", "createdAt", "updatedAt"].includes(key));
+        schema = UtilsServer.addIdToSchema(schema, UtilsServer.findLastIdNumber(schema, this.salt), this.salt, isTablePathExists);
+        if (!isTablePathExists)
+            await mkdir(tablePath, { recursive: true });
+        if (!(await File.isExists(join(tablePath, ".tmp"))))
+            await mkdir(join(tablePath, ".tmp"));
+        if (!(await File.isExists(join(tablePath, ".cache"))))
+            await mkdir(join(tablePath, ".cache"));
+        if (await File.isExists(tableSchemaPath)) {
+            // update columns files names based on field id
+            const replaceOldPathes = Utils.findChangedProperties(this._schemaToIdsPath((await this.getTableSchema(tableName)) ?? []), this._schemaToIdsPath(schema));
+            if (replaceOldPathes)
+                await Promise.all(Object.entries(replaceOldPathes).map(async ([oldPath, newPath]) => {
+                    if (await File.isExists(join(tablePath, oldPath)))
+                        await rename(join(tablePath, oldPath), join(tablePath, newPath));
+                }));
+        }
+        await File.write(join(tablePath, "schema.json"), JSON.stringify(isTablePathExists ? this._decodeIdFromSchema(schema) : schema, null, 2), true);
+    }
+    async getTableSchema(tableName) {
+        const tableSchemaPath = join(this.folder, this.database, tableName, "schema.json");
+        if (!(await File.isExists(tableSchemaPath)))
+            return undefined;
+        const schemaFile = await File.read(tableSchemaPath, true);
+        if (!schemaFile)
+            return undefined;
+        const schema = JSON.parse(schemaFile), lastIdNumber = UtilsServer.findLastIdNumber(schema, this.salt);
+        return [
+            {
+                id: UtilsServer.encodeID(0, this.salt),
+                key: "id",
+                type: "id",
+                required: true,
+            },
+            ...UtilsServer.addIdToSchema(schema, lastIdNumber, this.salt),
+            {
+                id: UtilsServer.encodeID(lastIdNumber + 1, this.salt),
+                key: "createdAt",
+                type: "date",
+                required: true,
+            },
+            {
+                id: UtilsServer.encodeID(lastIdNumber + 2, this.salt),
+                key: "updatedAt",
+                type: "date",
+                required: false,
+            },
+        ];
+    }
+    getField(keyPath, schema) {
+        let RETURN = null;
+        const keyPathSplited = keyPath.split(".");
+        for (const [index, key] of keyPathSplited.entries()) {
+            const foundItem = schema.find((item) => item.key === key);
+            if (!foundItem)
+                return null;
+            if (index === keyPathSplited.length - 1)
+                RETURN = foundItem;
+            if ((foundItem.type === "array" || foundItem.type === "object") &&
+                foundItem.children &&
+                Utils.isArrayOfObjects(foundItem.children))
+                RETURN = foundItem.children;
+        }
+        if (!RETURN)
+            return null;
+        return Utils.isArrayOfObjects(RETURN) ? RETURN[0] : RETURN;
+    }
+    validateData(data, schema, skipRequiredField = false) {
+        if (Utils.isArrayOfObjects(data))
+            for (const single_data of data)
+                this.validateData(single_data, schema, skipRequiredField);
+        else if (Utils.isObject(data)) {
+            for (const field of schema) {
+                if (!data.hasOwnProperty(field.key) &&
+                    field.required &&
+                    !skipRequiredField)
+                    throw this.throwError("FIELD_REQUIRED", field.key);
+                if (data.hasOwnProperty(field.key) &&
+                    !Utils.validateFieldType(data[field.key], field.type, (field.type === "array" || field.type === "object") &&
+                        field.children &&
+                        !Utils.isArrayOfObjects(field.children)
+                        ? field.children
+                        : undefined))
+                    throw this.throwError("INVALID_TYPE", [
+                        field.key,
+                        field.type,
+                        typeof data[field.key],
+                    ]);
+                if ((field.type === "array" || field.type === "object") &&
+                    field.children &&
+                    Utils.isArrayOfObjects(field.children))
+                    this.validateData(data[field.key], field.children, skipRequiredField);
+            }
+        }
+    }
+    formatField(value, field, formatOnlyAvailiableKeys) {
+        if (Array.isArray(field.type))
+            field.type = Utils.detectFieldType(value, field.type) ?? field.type[0];
+        switch (field.type) {
+            case "array":
+                if (typeof field.children === "string") {
+                    if (field.children === "table") {
+                        if (Array.isArray(value)) {
+                            if (Utils.isArrayOfObjects(value)) {
+                                if (value.every((item) => item.hasOwnProperty("id") &&
+                                    (Utils.isValidID(item.id) || Utils.isNumber(item.id))))
+                                    value.map((item) => item.id
+                                        ? Utils.isNumber(item.id)
+                                            ? Number(item.id)
+                                            : UtilsServer.decodeID(item.id, this.salt)
+                                        : null);
+                            }
+                            else if (value.every(Utils.isValidID) ||
+                                value.every(Utils.isNumber))
+                                return value.map((item) => Utils.isNumber(item)
+                                    ? Number(item)
+                                    : UtilsServer.decodeID(item, this.salt));
+                        }
+                        else if (Utils.isValidID(value))
+                            return [UtilsServer.decodeID(value, this.salt)];
+                        else if (Utils.isNumber(value))
+                            return [Number(value)];
+                    }
+                    else
+                        return Array.isArray(value) ? value : [value];
+                }
+                else if (Utils.isArrayOfObjects(field.children))
+                    return this.formatData(value, field.children, formatOnlyAvailiableKeys);
+                else if (Array.isArray(field.children))
+                    return Array.isArray(value) ? value : [value];
+                break;
+            case "object":
+                if (Utils.isArrayOfObjects(field.children))
+                    return this.formatData(value, field.children, formatOnlyAvailiableKeys);
+                break;
+            case "table":
+                if (Array.isArray(value))
+                    value = value[0];
+                if (Utils.isObject(value)) {
+                    if (value.hasOwnProperty("id") &&
+                        (Utils.isValidID(value.id) ||
+                            Utils.isNumber(value.id)))
+                        return Utils.isNumber(value.id)
+                            ? Number(value.id)
+                            : UtilsServer.decodeID(value.id, this.salt);
+                }
+                else if (Utils.isValidID(value) || Utils.isNumber(value))
+                    return Utils.isNumber(value)
+                        ? Number(value)
+                        : UtilsServer.decodeID(value, this.salt);
+                break;
+            case "password":
+                if (Array.isArray(value))
+                    value = value[0];
+                return Utils.isPassword(value)
+                    ? value
+                    : UtilsServer.hashPassword(String(value));
+            case "number":
+                if (Array.isArray(value))
+                    value = value[0];
+                return Utils.isNumber(value) ? Number(value) : null;
+            case "id":
+                if (Array.isArray(value))
+                    value = value[0];
+                return Utils.isNumber(value)
+                    ? value
+                    : UtilsServer.decodeID(value, this.salt);
+            case "json":
+                return JSON.stringify(value);
+            default:
+                return value;
+        }
+        return null;
+    }
+    formatData(data, schema, formatOnlyAvailiableKeys) {
+        this.validateData(data, schema, formatOnlyAvailiableKeys);
+        if (Utils.isArrayOfObjects(data))
+            return data.map((single_data) => this.formatData(single_data, schema, formatOnlyAvailiableKeys));
+        else if (Utils.isObject(data)) {
+            let RETURN = {};
+            for (const field of schema) {
+                if (!data.hasOwnProperty(field.key)) {
+                    if (formatOnlyAvailiableKeys || !field.required)
+                        continue;
+                    RETURN[field.key] = this.getDefaultValue(field);
+                    continue;
+                }
+                RETURN[field.key] = this.formatField(data[field.key], field, formatOnlyAvailiableKeys);
+            }
+            return RETURN;
+        }
+        else
+            return [];
+    }
+    getDefaultValue(field) {
+        if (Array.isArray(field.type))
+            return this.getDefaultValue({
+                ...field,
+                type: field.type.sort((a, b) => Number(b === "array") - Number(a === "array") ||
+                    Number(a === "string") - Number(b === "string") ||
+                    Number(a === "number") - Number(b === "number"))[0],
+            });
+        switch (field.type) {
+            case "array":
+                return Utils.isArrayOfObjects(field.children)
+                    ? [
+                        this.getDefaultValue({
+                            ...field,
+                            type: "object",
+                            children: field.children,
+                        }),
+                    ]
+                    : [];
+            case "object":
+                return Utils.combineObjects(field.children.map((f) => ({
+                    [f.key]: this.getDefaultValue(f),
+                })));
+            case "boolean":
+                return false;
+            default:
+                return null;
+        }
+    }
+    _combineObjectsToArray = (input) => input.reduce((result, current) => {
+        for (const [key, value] of Object.entries(current))
+            if (!result[key])
+                result[key] = [value];
+            else
+                result[key].push(value);
+        return result;
+    }, {});
+    _CombineData = (_data, prefix) => {
+        let RETURN = {};
+        if (Utils.isArrayOfObjects(_data))
+            RETURN = this._combineObjectsToArray(_data.map((single_data) => this._CombineData(single_data)));
+        else
+            for (const [key, value] of Object.entries(_data)) {
+                if (Utils.isObject(value))
+                    Object.assign(RETURN, this._CombineData(value, `${key}.`));
+                else if (Utils.isArrayOfObjects(value)) {
+                    Object.assign(RETURN, this._CombineData(this._combineObjectsToArray(value), (prefix ?? "") + key + "."));
+                }
+                else if (Utils.isArrayOfArrays(value) &&
+                    value.every(Utils.isArrayOfObjects))
+                    Object.assign(RETURN, this._CombineData(this._combineObjectsToArray(value.map(this._combineObjectsToArray)), (prefix ?? "") + key + "."));
+                else
+                    RETURN[(prefix ?? "") + key] = File.encode(value);
+            }
+        return RETURN;
+    };
+    _addPathToKeys = (obj, path) => {
+        const newObject = {};
+        for (const key in obj)
+            newObject[join(path, key + ".inib")] = obj[key];
+        return newObject;
+    };
+    joinPathesContents(mainPath, data) {
+        return this._addPathToKeys(this._CombineData(data), mainPath);
+    }
+    async getItemsFromSchema(tableName, schema, linesNumber, options, prefix) {
+        const tablePath = join(this.folder, this.database, tableName);
+        let RETURN = {};
+        await Promise.all(schema.map(async (field) => {
+            if ((field.type === "array" ||
+                (Array.isArray(field.type) && field.type.includes("array"))) &&
+                field.children) {
+                if (Utils.isArrayOfObjects(field.children)) {
+                    if (field.children.filter((children) => children.type === "array" &&
+                        Utils.isArrayOfObjects(children.children)).length) {
+                        // one of children has array field type and has children array of object = Schema
+                        Object.entries((await this.getItemsFromSchema(tableName, field.children.filter((children) => children.type === "array" &&
+                            Utils.isArrayOfObjects(children.children)), linesNumber, options, (prefix ?? "") + field.key + ".")) ?? {}).forEach(([index, item]) => {
+                            if (Utils.isObject(item)) {
+                                if (!RETURN[index])
+                                    RETURN[index] = {};
+                                if (!RETURN[index][field.key])
+                                    RETURN[index][field.key] = [];
+                                for (const child_field of field.children.filter((children) => children.type === "array" &&
+                                    Utils.isArrayOfObjects(children.children))) {
+                                    if (Utils.isObject(item[child_field.key])) {
+                                        Object.entries(item[child_field.key]).forEach(([key, value]) => {
+                                            if (!Utils.isArrayOfArrays(value))
+                                                value = value.map((_value) => child_field.type === "array"
+                                                    ? [[_value]]
+                                                    : [_value]);
+                                            for (let _i = 0; _i < value.length; _i++) {
+                                                if (Utils.isArrayOfNulls(value[_i]))
+                                                    continue;
+                                                if (!RETURN[index][field.key][_i])
+                                                    RETURN[index][field.key][_i] = {};
+                                                if (!RETURN[index][field.key][_i][child_field.key])
+                                                    RETURN[index][field.key][_i][child_field.key] =
+                                                        [];
+                                                value[_i].forEach((_element, _index) => {
+                                                    if (!RETURN[index][field.key][_i][child_field.key][_index])
+                                                        RETURN[index][field.key][_i][child_field.key][_index] = {};
+                                                    RETURN[index][field.key][_i][child_field.key][_index][key] = _element;
+                                                });
+                                            }
+                                        });
+                                    }
+                                }
+                            }
+                        });
+                        field.children = field.children.filter((children) => children.type !== "array" ||
+                            !Utils.isArrayOfObjects(children.children));
+                    }
+                    Object.entries((await this.getItemsFromSchema(tableName, field.children, linesNumber, options, (prefix ?? "") + field.key + ".")) ?? {}).forEach(([index, item]) => {
+                        if (!RETURN[index])
+                            RETURN[index] = {};
+                        if (Utils.isObject(item)) {
+                            if (!Object.values(item).every((i) => i === null)) {
+                                if (RETURN[index][field.key]) {
+                                    Object.entries(item).forEach(([key, value], _index) => {
+                                        RETURN[index][field.key] = RETURN[index][field.key].map((_obj, _i) => ({
+                                            ..._obj,
+                                            [key]: value[_i],
+                                        }));
+                                    });
+                                }
+                                else if (Object.values(item).every((_i) => Utils.isArrayOfArrays(_i) || Array.isArray(_i)))
+                                    RETURN[index][field.key] = item;
+                                else {
+                                    RETURN[index][field.key] = [];
+                                    Object.entries(item).forEach(([key, value]) => {
+                                        for (let _i = 0; _i < value.length; _i++) {
+                                            if (value[_i] === null ||
+                                                (Array.isArray(value[_i]) &&
+                                                    value[_i].every((_item) => _item === null)))
+                                                continue;
+                                            if (!RETURN[index][field.key][_i])
+                                                RETURN[index][field.key][_i] = {};
+                                            RETURN[index][field.key][_i][key] = value[_i];
+                                        }
+                                    });
+                                }
+                            }
+                            else
+                                RETURN[index][field.key] = null;
+                        }
+                        else
+                            RETURN[index][field.key] = item;
+                    });
+                }
+                else if (field.children === "table" ||
+                    (Array.isArray(field.type) && field.type.includes("table")) ||
+                    (Array.isArray(field.children) && field.children.includes("table"))) {
+                    if (options.columns)
+                        options.columns = options.columns
+                            .filter((column) => column.includes(`${field.key}.`))
+                            .map((column) => column.replace(`${field.key}.`, ""));
+                    const items = await File.get(join(tablePath, (prefix ?? "") + field.key + ".inib"), linesNumber, field.type, field.children, this.salt);
+                    if (items)
+                        await Promise.all(Object.entries(items).map(async ([index, item]) => {
+                            if (!RETURN[index])
+                                RETURN[index] = {};
+                            RETURN[index][field.key] = item
+                                ? await this.get(field.key, item, options)
+                                : this.getDefaultValue(field);
+                        }));
+                }
+                else if (await File.isExists(join(tablePath, (prefix ?? "") + field.key + ".inib"))) {
+                    const items = await File.get(join(tablePath, (prefix ?? "") + field.key + ".inib"), linesNumber, field.type, field?.children, this.salt);
+                    if (items)
+                        for (const [index, item] of Object.entries(items)) {
+                            if (!RETURN[index])
+                                RETURN[index] = {};
+                            RETURN[index][field.key] = item ?? this.getDefaultValue(field);
+                        }
+                }
+            }
+            else if (field.type === "object") {
+                for await (const [index, item] of Object.entries((await this.getItemsFromSchema(tableName, field.children, linesNumber, options, (prefix ?? "") + field.key + ".")) ?? {})) {
+                    if (!RETURN[index])
+                        RETURN[index] = {};
+                    if (Utils.isObject(item)) {
+                        if (!Object.values(item).every((i) => i === null))
+                            RETURN[index][field.key] = item;
+                        else
+                            RETURN[index][field.key] = null;
+                    }
+                    else
+                        RETURN[index][field.key] = null;
+                }
+            }
+            else if (field.type === "table") {
+                if ((await File.isExists(join(this.folder, this.database, field.key))) &&
+                    (await File.isExists(join(tablePath, (prefix ?? "") + field.key + ".inib")))) {
+                    if (options.columns)
+                        options.columns = options.columns
+                            .filter((column) => column.includes(`${field.key}.`) &&
+                            !column.includes(`${field.key}.`))
+                            .map((column) => column.replace(`${field.key}.`, ""));
+                    const items = await File.get(join(tablePath, (prefix ?? "") + field.key + ".inib"), linesNumber, "number", undefined, this.salt);
+                    if (items)
+                        for await (const [index, item] of Object.entries(items)) {
+                            if (!RETURN[index])
+                                RETURN[index] = {};
+                            RETURN[index][field.key] = item
+                                ? await this.get(field.key, item, options)
+                                : this.getDefaultValue(field);
+                        }
+                }
+            }
+            else if (await File.isExists(join(tablePath, (prefix ?? "") + field.key + ".inib"))) {
+                const items = await File.get(join(tablePath, (prefix ?? "") + field.key + ".inib"), linesNumber, field.type, field?.children, this.salt);
+                if (items)
+                    for (const [index, item] of Object.entries(items)) {
+                        if (!RETURN[index])
+                            RETURN[index] = {};
+                        RETURN[index][field.key] = item ?? this.getDefaultValue(field);
+                    }
+                else
+                    RETURN = Object.fromEntries(Object.entries(RETURN).map(([index, data]) => [
+                        index,
+                        { ...data, [field.key]: this.getDefaultValue(field) },
+                    ]));
+            }
+        }));
+        return RETURN;
+    }
+    async applyCriteria(tableName, schema, options, criteria, allTrue) {
+        const tablePath = join(this.folder, this.database, tableName);
+        let RETURN = {}, RETURN_LineNumbers = null;
+        if (!criteria)
+            return [null, null];
+        if (criteria.and && Utils.isObject(criteria.and)) {
+            const [searchResult, lineNumbers] = await this.applyCriteria(tableName, schema, options, criteria.and, true);
+            if (searchResult) {
+                RETURN = Utils.deepMerge(RETURN, Object.fromEntries(Object.entries(searchResult).filter(([_k, v], _i) => Object.keys(v).length === Object.keys(criteria.and ?? {}).length)));
+                delete criteria.and;
+                RETURN_LineNumbers = lineNumbers;
+            }
+            else
+                return [null, null];
+        }
+        if (criteria.or && Utils.isObject(criteria.or)) {
+            const [searchResult, lineNumbers] = await this.applyCriteria(tableName, schema, options, criteria.or, false);
+            delete criteria.or;
+            if (searchResult) {
+                RETURN = Utils.deepMerge(RETURN, searchResult);
+                RETURN_LineNumbers = lineNumbers;
+            }
+        }
+        if (Object.keys(criteria).length > 0) {
+            if (allTrue === undefined)
+                allTrue = true;
+            let index = -1;
+            for await (const [key, value] of Object.entries(criteria)) {
+                const field = this.getField(key, schema);
+                index++;
+                let searchOperator = undefined, searchComparedAtValue = undefined, searchLogicalOperator = undefined;
+                if (Utils.isObject(value)) {
+                    if (value?.or &&
+                        Array.isArray(value?.or)) {
+                        const searchCriteria = (value?.or)
+                            .map((single_or) => typeof single_or === "string"
+                            ? Utils.FormatObjectCriteriaValue(single_or)
+                            : ["=", single_or])
+                            .filter((a) => a);
+                        if (searchCriteria.length > 0) {
+                            searchOperator = searchCriteria.map((single_or) => single_or[0]);
+                            searchComparedAtValue = searchCriteria.map((single_or) => single_or[1]);
+                            searchLogicalOperator = "or";
+                        }
+                        delete value?.or;
+                    }
+                    if (value?.and &&
+                        Array.isArray(value?.and)) {
+                        const searchCriteria = (value?.and)
+                            .map((single_and) => typeof single_and === "string"
+                            ? Utils.FormatObjectCriteriaValue(single_and)
+                            : ["=", single_and])
+                            .filter((a) => a);
+                        if (searchCriteria.length > 0) {
+                            searchOperator = searchCriteria.map((single_and) => single_and[0]);
+                            searchComparedAtValue = searchCriteria.map((single_and) => single_and[1]);
+                            searchLogicalOperator = "and";
+                        }
+                        delete value?.and;
+                    }
+                }
+                else if (Array.isArray(value)) {
+                    const searchCriteria = value
+                        .map((single) => typeof single === "string"
+                        ? Utils.FormatObjectCriteriaValue(single)
+                        : ["=", single])
+                        .filter((a) => a);
+                    if (searchCriteria.length > 0) {
+                        searchOperator = searchCriteria.map((single) => single[0]);
+                        searchComparedAtValue = searchCriteria.map((single) => single[1]);
+                        searchLogicalOperator = "and";
+                    }
+                }
+                else if (typeof value === "string") {
+                    const ComparisonOperatorValue = Utils.FormatObjectCriteriaValue(value);
+                    if (ComparisonOperatorValue) {
+                        searchOperator = ComparisonOperatorValue[0];
+                        searchComparedAtValue = ComparisonOperatorValue[1];
+                    }
+                }
+                else {
+                    searchOperator = "=";
+                    searchComparedAtValue = value;
+                }
+                const [searchResult, totalLines, linesNumbers] = await File.search(join(tablePath, key + ".inib"), searchOperator ?? "=", searchComparedAtValue ?? null, searchLogicalOperator, field?.type, field?.children, options.perPage, options.page - 1 * options.perPage + 1, true, this.salt);
+                if (searchResult) {
+                    RETURN = Utils.deepMerge(RETURN, Object.fromEntries(Object.entries(searchResult).map(([id, value]) => [
+                        id,
+                        {
+                            [key]: value,
+                        },
+                    ])));
+                    this.totalItems[tableName + "-" + key] = totalLines;
+                    RETURN_LineNumbers = linesNumbers;
+                }
+                if (allTrue && index > 0) {
+                    if (!Object.keys(RETURN).length)
+                        RETURN = {};
+                    RETURN = Object.fromEntries(Object.entries(RETURN).filter(([_index, item]) => Object.keys(item).length > index));
+                    if (!Object.keys(RETURN).length)
+                        RETURN = {};
+                }
+            }
+        }
+        return [Object.keys(RETURN).length ? RETURN : null, RETURN_LineNumbers];
+    }
+    _filterSchemaByColumns(schema, columns) {
+        return schema
+            .map((field) => {
+            if (columns.some((column) => column.startsWith("!")))
+                return columns.includes("!" + field.key) ? null : field;
+            if (columns.includes(field.key) || columns.includes("*"))
+                return field;
+            if ((field.type === "array" || field.type === "object") &&
+                Utils.isArrayOfObjects(field.children) &&
+                columns.filter((column) => column.startsWith(field.key + ".") ||
+                    column.startsWith("!" + field.key + ".")).length) {
+                field.children = this._filterSchemaByColumns(field.children, columns
+                    .filter((column) => column.startsWith(field.key + ".") ||
+                    column.startsWith("!" + field.key + "."))
+                    .map((column) => column.replace(field.key + ".", "")));
+                return field;
+            }
+            return null;
+        })
+            .filter((i) => i);
+    }
+    async clearCache(tablePath) {
+        await Promise.all((await readdir(join(tablePath, ".cache")))
+            ?.filter((fileName) => fileName !== "pagination.inib")
+            .map(async (file) => unlink(join(tablePath, ".cache", file))));
+    }
+    async get(tableName, where, options = {
+        page: 1,
+        perPage: 15,
+    }, onlyOne, onlyLinesNumbers, tableSchema) {
+        const tablePath = join(this.folder, this.database, tableName);
+        // Ensure options.columns is an array
+        if (options.columns) {
+            options.columns = Array.isArray(options.columns)
+                ? options.columns
+                : [options.columns];
+            if (options.columns.length && !options.columns.includes("id"))
+                options.columns.push("id");
+        }
+        // Default values for page and perPage
+        options.page = options.page || 1;
+        options.perPage = options.perPage || 15;
+        let RETURN;
+        let schema = tableSchema ?? (await this.getTableSchema(tableName));
+        if (!schema)
+            throw this.throwError("NO_SCHEMA", tableName);
+        if (!(await File.isExists(join(tablePath, "id.inib"))))
+            return null;
+        if (options.columns && options.columns.length)
+            schema = this._filterSchemaByColumns(schema, options.columns);
+        if (!where) {
+            // Display all data
+            RETURN = Object.values(await this.getItemsFromSchema(tableName, schema, Array.from({ length: options.perPage }, (_, index) => (options.page - 1) * options.perPage +
+                index +
+                1), options));
+            if (Config.isCacheEnabled &&
+                (await File.isExists(join(tablePath, ".cache", "pagination.inib"))))
+                this.totalItems[tableName + "-*"] = Number((await File.read(join(tablePath, ".cache", "pagination.inib"), true)).split(",")[1]);
+            else {
+                let [lastId, totalItems] = await File.get(join(tablePath, "id.inib"), -1, "number", undefined, this.salt, true);
+                if (lastId)
+                    lastId = Number(Object.keys(lastId)[0] ?? 0);
+                this.totalItems[tableName + "-*"] = totalItems;
+                if (Config.isCacheEnabled)
+                    await File.write(join(tablePath, ".cache", "pagination.inib"), `${lastId},${totalItems}`, true);
+            }
+        }
+        else if ((Array.isArray(where) && where.every(Utils.isNumber)) ||
+            (Utils.isNumber(where) && !onlyLinesNumbers)) {
+            // "where" in this case, is the lineNumbers instead of IDs
+            let lineNumbers = where;
+            if (!Array.isArray(lineNumbers))
+                lineNumbers = [lineNumbers];
+            RETURN = Object.values((await this.getItemsFromSchema(tableName, schema, lineNumbers, options)) ?? {});
+            if (!this.totalItems[tableName + "-*"])
+                this.totalItems[tableName + "-*"] = lineNumbers.length;
+            if (RETURN && RETURN.length && !Array.isArray(where))
+                RETURN = RETURN[0];
+        }
+        else if ((Array.isArray(where) &&
+            (where.every(Utils.isValidID) || where.every(Utils.isNumber))) ||
+            Utils.isValidID(where) ||
+            Utils.isNumber(where)) {
+            let Ids = where;
+            if (!Array.isArray(Ids))
+                Ids = [Ids];
+            const [lineNumbers, countItems] = await File.search(join(tablePath, "id.inib"), "[]", Ids.map((id) => Utils.isNumber(id) ? Number(id) : UtilsServer.decodeID(id, this.salt)), undefined, "number", undefined, Ids.length, 0, !this.totalItems[tableName + "-*"], this.salt);
+            if (!lineNumbers)
+                throw this.throwError("NO_RESULTS", tableName);
+            if (onlyLinesNumbers)
+                return Object.keys(lineNumbers).length
+                    ? Object.keys(lineNumbers).map(Number)
+                    : null;
+            RETURN = Object.values((await this.getItemsFromSchema(tableName, schema, Object.keys(lineNumbers).map(Number), options)) ?? {});
+            if (!this.totalItems[tableName + "-*"])
+                this.totalItems[tableName + "-*"] = countItems;
+            if (RETURN && RETURN.length && !Array.isArray(where))
+                RETURN = RETURN[0];
+        }
+        else if (Utils.isObject(where)) {
+            let cachedFilePath = "";
+            // Criteria
+            if (Config.isCacheEnabled)
+                cachedFilePath = join(tablePath, ".cache", `${UtilsServer.hashString(inspect(where, { sorted: true }))}.inib`);
+            if (Config.isCacheEnabled && (await File.isExists(cachedFilePath))) {
+                const cachedItems = (await File.read(cachedFilePath, true)).split(",");
+                this.totalItems[tableName + "-*"] = cachedItems.length;
+                if (onlyLinesNumbers)
+                    return cachedItems.map(Number);
+                return this.get(tableName, cachedItems
+                    .slice((options.page - 1) * options.perPage, options.page * options.perPage)
+                    .map(Number), options, undefined, undefined, schema);
+            }
+            else {
+                let linesNumbers;
+                [RETURN, linesNumbers] = await this.applyCriteria(tableName, schema, options, where);
+                if (RETURN && linesNumbers) {
+                    if (onlyLinesNumbers)
+                        return Object.keys(RETURN).map(Number);
+                    const alreadyExistsColumns = Object.keys(Object.values(RETURN)[0]);
+                    RETURN = Object.values(Utils.deepMerge(RETURN, await this.getItemsFromSchema(tableName, schema.filter(({ key }) => !alreadyExistsColumns.includes(key)), Object.keys(RETURN).map(Number), options)));
+                    if (Config.isCacheEnabled)
+                        await File.write(cachedFilePath, Array.from(linesNumbers).join(","), true);
+                }
+            }
+        }
+        if (!RETURN ||
+            (Utils.isObject(RETURN) && !Object.keys(RETURN).length) ||
+            (Array.isArray(RETURN) && !RETURN.length))
+            return null;
+        const greatestTotalItems = this.totalItems[tableName + "-*"] ??
+            Math.max(...Object.entries(this.totalItems)
+                .filter(([k]) => k.startsWith(tableName + "-"))
+                .map(([, v]) => v));
+        this.pageInfo[tableName] = {
+            ...(({ columns, ...restOfOptions }) => restOfOptions)(options),
+            perPage: Array.isArray(RETURN) ? RETURN.length : 1,
+            totalPages: Math.ceil(greatestTotalItems / options.perPage),
+            total: greatestTotalItems,
+        };
+        return onlyOne && Array.isArray(RETURN) ? RETURN[0] : RETURN;
+    }
+    async post(tableName, data, options, returnPostedData) {
+        if (!options)
+            options = {
+                page: 1,
+                perPage: 15,
+            };
+        const tablePath = join(this.folder, this.database, tableName);
+        if (!returnPostedData)
+            returnPostedData = false;
+        const schema = await this.getTableSchema(tableName);
+        let RETURN;
+        if (!schema)
+            throw this.throwError("NO_SCHEMA", tableName);
+        const keys = UtilsServer.hashString(Object.keys(Array.isArray(data) ? data[0] : data).join("."));
+        let lastId = 0, totalItems = 0, renameList = [];
+        try {
+            await File.lock(join(tablePath, ".tmp"), keys);
+            if (await File.isExists(join(tablePath, "id.inib"))) {
+                if (Config.isCacheEnabled &&
+                    (await File.isExists(join(tablePath, ".cache", "pagination.inib"))))
+                    [lastId, totalItems] = (await File.read(join(tablePath, ".cache", "pagination.inib"), true))
+                        .split(",")
+                        .map(Number);
+                else {
+                    let lastIdObj;
+                    [lastIdObj, totalItems] = await File.get(join(tablePath, "id.inib"), -1, "number", undefined, this.salt, true);
+                    if (lastIdObj)
+                        lastId = Number(Object.keys(lastIdObj)[0] ?? 0);
+                }
+            }
+            if (Utils.isArrayOfObjects(data))
+                RETURN = data.map(({ id, updatedAt, createdAt, ...rest }) => ({
+                    id: ++lastId,
+                    ...rest,
+                    createdAt: Date.now(),
+                }));
+            else
+                RETURN = (({ id, updatedAt, createdAt, ...rest }) => ({
+                    id: ++lastId,
+                    ...rest,
+                    createdAt: Date.now(),
+                }))(data);
+            RETURN = this.formatData(RETURN, schema);
+            const pathesContents = this.joinPathesContents(tablePath, Config.isReverseEnabled
+                ? Array.isArray(RETURN)
+                    ? RETURN.toReversed()
+                    : RETURN
+                : RETURN);
+            await Promise.all(Object.entries(pathesContents).map(async ([path, content]) => renameList.push(this.isThreadEnabled
+                ? await File.createWorker("append", [path, content])
+                : await File.append(path, content))));
+            await Promise.all(renameList.map(async ([tempPath, filePath]) => rename(tempPath, filePath)));
+            renameList = [];
+            if (Config.isCacheEnabled) {
+                await this.clearCache(tablePath);
+                await File.write(join(tablePath, ".cache", "pagination.inib"), `${lastId},${totalItems + (Array.isArray(RETURN) ? RETURN.length : 1)}`, true);
+            }
+            if (returnPostedData)
+                return this.get(tableName, Array.isArray(RETURN) ? RETURN.map((_, index) => index + 1) : 1, options, !Utils.isArrayOfObjects(data), // return only one item if data is not array of objects
+                undefined, schema);
+        }
+        finally {
+            if (renameList.length)
+                await Promise.allSettled(renameList.map(async ([tempPath, _]) => unlink(tempPath)));
+            await File.unlock(join(tablePath, ".tmp"), keys);
+        }
+    }
+    async put(tableName, data, where, options = {
+        page: 1,
+        perPage: 15,
+    }, returnPostedData) {
+        let renameList = [];
+        const tablePath = join(this.folder, this.database, tableName);
+        const schema = await this.getTableSchema(tableName);
+        if (!schema)
+            throw this.throwError("NO_SCHEMA", tableName);
+        if (!(await File.isExists(join(tablePath, "id.inib"))))
+            throw this.throwError("NO_ITEMS", tableName);
+        data = this.formatData(data, schema, true);
+        if (!where) {
+            if (Utils.isArrayOfObjects(data)) {
+                if (!data.every((item) => item.hasOwnProperty("id") && Utils.isValidID(item.id)))
+                    throw this.throwError("INVALID_ID");
+                return this.put(tableName, data, data
+                    .filter((item) => item.id !== undefined)
+                    .map((item) => item.id));
+            }
+            else if (data.hasOwnProperty("id")) {
+                if (!Utils.isValidID(data.id))
+                    throw this.throwError("INVALID_ID", data.id);
+                return this.put(tableName, data, UtilsServer.decodeID(data.id, this.salt));
+            }
+            else {
+                let totalItems;
+                if (Config.isCacheEnabled &&
+                    (await File.isExists(join(tablePath, ".cache", "pagination.inib"))))
+                    totalItems = (await File.read(join(tablePath, ".cache", "pagination.inib"), true))
+                        .split(",")
+                        .map(Number)[1];
+                else
+                    totalItems = await File.count(join(tablePath, "id.inib"));
+                const pathesContents = this.joinPathesContents(tablePath, {
+                    ...(({ id, ...restOfData }) => restOfData)(data),
+                    updatedAt: Date.now(),
+                });
+                try {
+                    await File.lock(join(tablePath, ".tmp"));
+                    await Promise.all(Object.entries(pathesContents).map(async ([path, content]) => renameList.push(this.isThreadEnabled
+                        ? await File.createWorker("replace", [
+                            path,
+                            Utils.combineObjects([...Array(totalItems)].map((_, i) => ({
+                                [`${i + 1}`]: content,
+                            }))),
+                        ])
+                        : await File.replace(path, Utils.combineObjects([...Array(totalItems)].map((_, i) => ({
+                            [`${i + 1}`]: content,
+                        })))))));
+                    await Promise.all(renameList.map(async ([tempPath, filePath]) => rename(tempPath, filePath)));
+                    if (Config.isCacheEnabled)
+                        await this.clearCache(join(tablePath, ".cache"));
+                    if (returnPostedData)
+                        return this.get(tableName, where, options, undefined, undefined, schema);
+                }
+                finally {
+                    if (renameList.length)
+                        await Promise.allSettled(renameList.map(async ([tempPath, _]) => unlink(tempPath)));
+                    await File.unlock(join(tablePath, ".tmp"));
+                }
+            }
+        }
+        else if ((Array.isArray(where) &&
+            (where.every(Utils.isValidID) || where.every(Utils.isNumber))) ||
+            Utils.isValidID(where) ||
+            Utils.isNumber(where)) {
+            if ((Array.isArray(where) && where.every(Utils.isValidID)) ||
+                Utils.isValidID(where)) {
+                const lineNumbers = await this.get(tableName, where, undefined, undefined, true, schema);
+                return this.put(tableName, data, lineNumbers);
+            }
+            else if ((Array.isArray(where) && where.every(Utils.isNumber)) ||
+                Utils.isNumber(where)) {
+                // "where" in this case, is the line(s) number(s) and not id(s)
+                const pathesContents = Object.fromEntries(Object.entries(this.joinPathesContents(tablePath, Utils.isArrayOfObjects(data)
+                    ? data.map((item) => ({
+                        ...item,
+                        updatedAt: Date.now(),
+                    }))
+                    : { ...data, updatedAt: Date.now() })).map(([path, content]) => [
+                    path,
+                    [...(Array.isArray(where) ? where : [where])].reduce((obj, lineNum, index) => ({
+                        ...obj,
+                        [lineNum]: Array.isArray(content) ? content[index] : content,
+                    }), {}),
+                ]));
+                const keys = UtilsServer.hashString(Object.keys(pathesContents)
+                    .map((path) => path.replaceAll(".inib", ""))
+                    .join("."));
+                try {
+                    await File.lock(join(tablePath, ".tmp"), keys);
+                    await Promise.all(Object.entries(pathesContents).map(async ([path, content]) => renameList.push(this.isThreadEnabled
+                        ? await File.createWorker("replace", [path, content])
+                        : await File.replace(path, content))));
+                    await Promise.all(renameList.map(async ([tempPath, filePath]) => rename(tempPath, filePath)));
+                    renameList = [];
+                    if (Config.isCacheEnabled)
+                        await this.clearCache(tablePath);
+                    if (returnPostedData)
+                        return this.get(tableName, where, options, !Array.isArray(where), undefined, schema);
+                }
+                finally {
+                    if (renameList.length)
+                        await Promise.allSettled(renameList.map(async ([tempPath, _]) => unlink(tempPath)));
+                    await File.unlock(join(tablePath, ".tmp"), keys);
+                }
+            }
+        }
+        else if (Utils.isObject(where)) {
+            const lineNumbers = await this.get(tableName, where, undefined, undefined, true, schema);
+            if (!lineNumbers || !lineNumbers.length)
+                throw this.throwError("NO_RESULTS", tableName);
+            return this.put(tableName, data, lineNumbers);
+        }
+        else
+            throw this.throwError("INVALID_PARAMETERS");
+    }
+    async delete(tableName, where, _id) {
+        let renameList = [];
+        const tablePath = join(this.folder, this.database, tableName);
+        const schema = await this.getTableSchema(tableName);
+        if (!schema)
+            throw this.throwError("NO_SCHEMA", tableName);
+        if (!(await File.isExists(join(tablePath, "id.inib"))))
+            throw this.throwError("NO_ITEMS", tableName);
+        if (!where) {
+            try {
+                await File.lock(join(tablePath, ".tmp"));
+                await Promise.all((await readdir(tablePath))
+                    ?.filter((fileName) => fileName.endsWith(".inib"))
+                    .map(async (file) => unlink(join(tablePath, file))));
+                if (Config.isCacheEnabled)
+                    await this.clearCache(tablePath);
+            }
+            finally {
+                await File.unlock(join(tablePath, ".tmp"));
+            }
+            return "*";
+        }
+        else if ((Array.isArray(where) &&
+            (where.every(Utils.isValidID) || where.every(Utils.isNumber))) ||
+            Utils.isValidID(where) ||
+            Utils.isNumber(where)) {
+            if ((Array.isArray(where) && where.every(Utils.isValidID)) ||
+                Utils.isValidID(where)) {
+                const lineNumbers = await this.get(tableName, where, undefined, undefined, true, schema);
+                if (!lineNumbers)
+                    return null;
+                return this.delete(tableName, lineNumbers, where);
+            }
+            else if ((Array.isArray(where) && where.every(Utils.isNumber)) ||
+                Utils.isNumber(where)) {
+                // "where" in this case, is the line(s) number(s) and not id(s)
+                const files = (await readdir(tablePath))?.filter((fileName) => fileName.endsWith(".inib"));
+                if (files.length) {
+                    if (!_id)
+                        _id = Object.entries((await File.get(join(tablePath, "id.inib"), where, "number", undefined, this.salt)) ?? {}).map(([_key, id]) => UtilsServer.encodeID(Number(id), this.salt));
+                    if (!_id.length)
+                        throw this.throwError("NO_RESULTS", tableName);
+                    try {
+                        await File.lock(join(tablePath, ".tmp"));
+                        await Promise.all(files.map(async (file) => renameList.push(this.isThreadEnabled
+                            ? await File.createWorker("remove", [
+                                join(tablePath, file),
+                                where,
+                            ])
+                            : await File.remove(join(tablePath, file), where))));
+                        await Promise.all(renameList.map(async ([tempPath, filePath]) => rename(tempPath, filePath)));
+                        if (Config.isCacheEnabled) {
+                            await this.clearCache(tablePath);
+                            if (await File.isExists(join(tablePath, ".cache", "pagination.inib"))) {
+                                let [lastId, totalItems] = (await File.read(join(tablePath, ".cache", "pagination.inib"), true))
+                                    .split(",")
+                                    .map(Number);
+                                await File.write(join(tablePath, ".cache", "pagination.inib"), `${lastId},${totalItems - (Array.isArray(where) ? where.length : 1)}`, true);
+                            }
+                        }
+                        return Array.isArray(_id) && _id.length === 1 ? _id[0] : _id;
+                    }
+                    finally {
+                        if (renameList.length)
+                            await Promise.allSettled(renameList.map(async ([tempPath, _]) => unlink(tempPath)));
+                        await File.unlock(join(tablePath, ".tmp"));
+                    }
+                }
+            }
+        }
+        else if (Utils.isObject(where)) {
+            const lineNumbers = await this.get(tableName, where, undefined, undefined, true, schema);
+            if (!lineNumbers || !lineNumbers.length)
+                throw this.throwError("NO_RESULTS", tableName);
+            return this.delete(tableName, lineNumbers);
+        }
+        else
+            throw this.throwError("INVALID_PARAMETERS");
+        return null;
+    }
+    async sum(tableName, columns, where) {
+        let RETURN = {};
+        const tablePath = join(this.folder, this.database, tableName), schema = await this.getTableSchema(tableName);
+        if (!schema)
+            throw this.throwError("NO_SCHEMA", tableName);
+        if (!(await File.isExists(join(tablePath, "id.inib"))))
+            throw this.throwError("NO_ITEMS", tableName);
+        if (!Array.isArray(columns))
+            columns = [columns];
+        for await (const column of columns) {
+            const columnPath = join(tablePath, column + ".inib");
+            if (await File.isExists(columnPath)) {
+                if (where) {
+                    const lineNumbers = await this.get(tableName, where, undefined, undefined, true, schema);
+                    RETURN[column] = lineNumbers
+                        ? await File.sum(columnPath, lineNumbers)
+                        : 0;
+                }
+                else
+                    RETURN[column] = await File.sum(columnPath);
+            }
+        }
+        return Array.isArray(columns) ? RETURN : Object.values(RETURN)[0];
+    }
+    async max(tableName, columns, where) {
+        let RETURN = {};
+        const tablePath = join(this.folder, this.database, tableName), schema = await this.getTableSchema(tableName);
+        if (!schema)
+            throw this.throwError("NO_SCHEMA", tableName);
+        if (!(await File.isExists(join(tablePath, "id.inib"))))
+            throw this.throwError("NO_ITEMS", tableName);
+        if (!Array.isArray(columns))
+            columns = [columns];
+        for await (const column of columns) {
+            const columnPath = join(tablePath, column + ".inib");
+            if (await File.isExists(columnPath)) {
+                if (where) {
+                    const lineNumbers = await this.get(tableName, where, undefined, undefined, true, schema);
+                    RETURN[column] = lineNumbers
+                        ? await File.max(columnPath, lineNumbers)
+                        : 0;
+                }
+                else
+                    RETURN[column] = await File.max(columnPath);
+            }
+        }
+        return RETURN;
+    }
+    async min(tableName, columns, where) {
+        let RETURN = {};
+        const tablePath = join(this.folder, this.database, tableName), schema = await this.getTableSchema(tableName);
+        if (!schema)
+            throw this.throwError("NO_SCHEMA", tableName);
+        if (!(await File.isExists(join(tablePath, "id.inib"))))
+            throw this.throwError("NO_ITEMS", tableName);
+        if (!Array.isArray(columns))
+            columns = [columns];
+        for await (const column of columns) {
+            const columnPath = join(tablePath, column + ".inib");
+            if (await File.isExists(columnPath)) {
+                if (where) {
+                    const lineNumbers = await this.get(tableName, where, undefined, undefined, true, schema);
+                    RETURN[column] = lineNumbers
+                        ? await File.min(columnPath, lineNumbers)
+                        : 0;
+                }
+                else
+                    RETURN[column] = await File.min(columnPath);
+            }
+        }
+        return RETURN;
+    }
+}