@wxn0brp/db/dist/db/valthera.js

A simple file-based database management system with support for CRUD operations, custom queries, and graph structures.

import { EventEmitter } from "events";
import dbActionC from "../actions/action.js";
import vFileCpu from "../file/index.js";
import CollectionManager from "../helpers/CollectionManager.js";
import executorC from "../helpers/executor.js";
import { version } from "../version.js";
/**
 * Represents a database management class for performing CRUD operations.
 * @class
 */
class Valthera {
    dbAction;
    executor;
    emiter;
    version = version;
    constructor(folder, options = {}, fileCpu) {
        if (!fileCpu)
            fileCpu = vFileCpu;
        this.dbAction = options.dbAction || new dbActionC(folder, options, fileCpu);
        this.executor = options.executor || new executorC();
        this.emiter = new EventEmitter();
    }
    async execute(name, ...args) {
        const result = await this.executor.addOp(this.dbAction[name].bind(this.dbAction), ...args);
        if (this.emiter.listeners(name).length !== 0)
            this.emiter.emit(name, args, result);
        if (this.emiter.listeners("*").length !== 0)
            this.emiter.emit("*", name, args, result);
        return result;
    }
    /**
     * Create a new instance of a CollectionManager class.
     */
    c(collection) {
        return new CollectionManager(this, collection);
    }
    /**
     * Get the names of all available databases.
     */
    async getCollections() {
        return await this.execute("getCollections");
    }
    /**
     * Check and create the specified collection if it doesn't exist.
     */
    async checkCollection(collection) {
        return await this.execute("checkCollection", { collection });
    }
    /**
     * Check if a collection exists.
     */
    async issetCollection(collection) {
        return await this.execute("issetCollection", { collection });
    }
    /**
     * Add data to a database.
     */
    async add(collection, data, id_gen = true) {
        return await this.execute("add", { collection, data, id_gen });
    }
    /**
     * Find data in a database.
     */
    async find(collection, search, context = {}, dbFindOpts = {}, findOpts = {}) {
        return await this.execute("find", { collection, search, context, dbFindOpts, findOpts });
    }
    /**
     * Find one data entry in a database.
     */
    async findOne(collection, search, context = {}, findOpts = {}) {
        return await this.execute("findOne", { collection, search, context, findOpts });
    }
    /**
     * Update data in a database.
     */
    async update(collection, search, updater, context = {}) {
        return await this.execute("update", { collection, search, updater, context });
    }
    /**
     * Update one data entry in a database.
     */
    async updateOne(collection, search, updater, context = {}) {
        return await this.execute("updateOne", { collection, search, updater, context });
    }
    /**
     * Remove data from a database.
     */
    async remove(collection, search, context = {}) {
        return await this.execute("remove", { collection, search, context });
    }
    /**
     * Remove one data entry from a database.
     */
    async removeOne(collection, search, context = {}) {
        return await this.execute("removeOne", { collection, search, context });
    }
    /**
     * Asynchronously updates one entry in a database or adds a new one if it doesn't exist.
     */
    async updateOneOrAdd(collection, search, updater, add_arg = {}, context = {}, id_gen = true) {
        return await this.execute("updateOneOrAdd", { collection, search, updater, add_arg, context, id_gen });
    }
    /**
     * Removes a database collection from the file system.
     */
    async removeCollection(collection) {
        return await this.execute("removeCollection", { collection });
    }
}
export default Valthera;