@wxn0brp/db 0.4.1 → 0.5.1

package/dist/action.d.ts

@@ -4,6 +4,7 @@ import { Context } from "./types/types.js";
 import { SearchOptions } from "./types/searchOpts.js";
 import Data from "./types/data.js";
 import FileCpu from "./types/fileCpu.js";
+import { Transaction } from "./types/transactions.js";
 /**
  * A class representing database actions on files.
  * @class
@@ -64,5 +65,9 @@ declare class dbActionC {
      * Removes a database collection from the file system.
      */
     removeCollection(collection: string): Promise<void>;
+    /**
+     * Apply a series of transactions to a database collection.
+     */
+    transaction(collection: string, transactions: Transaction[]): Promise<void>;
 }
 export default dbActionC;

package/dist/action.js

@@ -156,6 +156,23 @@ class dbActionC {
     async removeCollection(collection) {
         await promises.rm(this.folder + "/" + collection, { recursive: true, force: true });
     }
+    /**
+     * Apply a series of transactions to a database collection.
+     */
+    async transaction(collection, transactions) {
+        await this.checkCollection(collection);
+        const files = await getSortedFiles(this._getCollectionPath(collection));
+        if (files.length == 0) {
+            await promises.writeFile(this._getCollectionPath(collection) + "1.db", "");
+            files.push("1.db");
+        }
+        for (const file of files) {
+            await this.fileCpu.transactions(this._getCollectionPath(collection) + file, transactions);
+        }
+        console.log("Transactions applied successfully.");
+        console.log("Files:", files);
+        console.log("Transactions:", transactions);
+    }
 }
 /**
  * Get the last file in the specified directory.

package/dist/client/database.d.ts

@@ -4,6 +4,7 @@ import { Arg, Search, Updater } from "../types/arg.js";
 import { DbFindOpts, FindOpts } from "../types/options.js";
 import { Context } from "../types/types.js";
 import Data from "../types/data.js";
+import { Transaction } from "../types/transactions.js";
 /**
  * Represents a database management class for performing CRUD operations.
  * Uses a remote database.
@@ -68,5 +69,9 @@ declare class DataBaseRemote {
      * Removes a database collection from the file system.
      */
     removeCollection(name: string): Promise<boolean>;
+    /**
+     * Execute a transaction.
+     */
+    transaction(collection: string, transaction: Transaction[]): Promise<boolean>;
 }
 export default DataBaseRemote;

package/dist/client/database.js

@@ -110,5 +110,11 @@ class DataBaseRemote {
     async removeCollection(name) {
         return await this._request("removeCollection", [name]);
     }
+    /**
+     * Execute a transaction.
+     */
+    async transaction(collection, transaction) {
+        return await this._request("transaction", [collection, transaction]);
+    }
 }
 export default DataBaseRemote;

package/dist/database.d.ts

@@ -6,6 +6,8 @@ import { Arg, Search, Updater } from "./types/arg.js";
 import Data from "./types/data.js";
 import { Context } from "./types/types.js";
 import FileCpu from "./types/fileCpu.js";
+import { Transaction } from "./types/transactions.js";
+import { EventEmitter } from "events";
 /**
  * Represents a database management class for performing CRUD operations.
  * @class
@@ -13,7 +15,9 @@ import FileCpu from "./types/fileCpu.js";
 declare class DataBase {
     dbAction: dbActionC;
     executor: executorC;
+    emiter: EventEmitter;
     constructor(folder: string, options?: DbOpts, fileCpu?: FileCpu);
+    private execute;
     /**
      * Create a new instance of a CollectionManager class.
      */
@@ -25,7 +29,7 @@ declare class DataBase {
     /**
      * Check and create the specified collection if it doesn't exist.
      */
-    checkCollection(collection: string): Promise<void>;
+    checkCollection(collection: string): Promise<boolean>;
     /**
      * Check if a collection exists.
      */
@@ -65,6 +69,10 @@ declare class DataBase {
     /**
      * Removes a database collection from the file system.
      */
-    removeCollection(collection: string): Promise<void>;
+    removeCollection(collection: string): Promise<boolean>;
+    /**
+     * Execute a transaction.
+     */
+    transaction(collection: string, transaction: Transaction[]): Promise<boolean>;
 }
 export default DataBase;

package/dist/database.js

@@ -2,6 +2,7 @@ import dbActionC from "./action.js";
 import executorC from "./executor.js";
 import CollectionManager from "./CollectionManager.js";
 import vFileCpu from "./file/index.js";
+import { EventEmitter } from "events";
 /**
  * Represents a database management class for performing CRUD operations.
  * @class
@@ -9,11 +10,21 @@ import vFileCpu from "./file/index.js";
 class DataBase {
     dbAction;
     executor;
+    emiter;
     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.
@@ -25,61 +36,61 @@ class DataBase {
      * Get the names of all available databases.
      */
     async getCollections() {
-        return await this.dbAction.getCollections();
+        return await this.execute("getCollections");
     }
     /**
      * Check and create the specified collection if it doesn't exist.
      */
     async checkCollection(collection) {
-        await this.dbAction.checkCollection(collection);
+        return await this.execute("checkCollection", collection);
     }
     /**
      * Check if a collection exists.
      */
     async issetCollection(collection) {
-        return await this.dbAction.issetCollection(collection);
+        return await this.execute("issetCollection", collection);
     }
     /**
      * Add data to a database.
      */
     async add(collection, data, id_gen = true) {
-        return await this.executor.addOp(this.dbAction.add.bind(this.dbAction), collection, data, id_gen);
+        return await this.execute("add", collection, data, id_gen);
     }
     /**
      * Find data in a database.
      */
     async find(collection, search, context = {}, options = {}, findOpts = {}) {
-        return await this.executor.addOp(this.dbAction.find.bind(this.dbAction), collection, search, context, options, findOpts);
+        return await this.execute("find", collection, search, context, options, findOpts);
     }
     /**
      * Find one data entry in a database.
      */
     async findOne(collection, search, context = {}, findOpts = {}) {
-        return await this.executor.addOp(this.dbAction.findOne.bind(this.dbAction), 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.executor.addOp(this.dbAction.update.bind(this.dbAction), 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.executor.addOp(this.dbAction.updateOne.bind(this.dbAction), 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.executor.addOp(this.dbAction.remove.bind(this.dbAction), 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.executor.addOp(this.dbAction.removeOne.bind(this.dbAction), 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.
@@ -88,12 +99,24 @@ class DataBase {
         const res = await this.updateOne(collection, search, updater, context);
         if (!res) {
             const assignData = [];
-            if (typeof search === "object" && !Array.isArray(search))
-                assignData.push(search);
-            if (typeof updater === "object" && !Array.isArray(updater))
-                assignData.push(updater);
-            if (typeof add_arg === "object" && !Array.isArray(add_arg))
-                assignData.push(add_arg);
+            function assignDataPush(data) {
+                if (typeof data !== "object" || Array.isArray(data))
+                    return;
+                const obj = {};
+                for (const key of Object.keys(data)) {
+                    if (key.startsWith("$")) {
+                        Object.keys(data[key]).forEach((k) => {
+                            obj[k] = data[key][k];
+                        });
+                    }
+                    else
+                        obj[key] = data[key];
+                }
+                assignData.push(obj);
+            }
+            assignDataPush(search);
+            assignDataPush(updater);
+            assignDataPush(add_arg);
             await this.add(collection, Object.assign({}, ...assignData), id_gen);
         }
         return res;
@@ -102,7 +125,13 @@ class DataBase {
      * Removes a database collection from the file system.
      */
     async removeCollection(collection) {
-        await this.dbAction.removeCollection(collection);
+        return await this.execute("removeCollection", collection);
+    }
+    /**
+     * Execute a transaction.
+     */
+    async transaction(collection, transaction) {
+        return await this.execute("transaction", collection, transaction);
     }
 }
 export default DataBase;

package/dist/file/customFileCpu.d.ts

@@ -3,6 +3,7 @@ import { Search, Updater } from "../types/arg.js";
 import Data from "../types/data.js";
 import FileCpu from "../types/fileCpu.js";
 import { FindOpts } from "../types/options.js";
+import { Transaction } from "../types/transactions.js";
 export type WriteFile = (file: string, data: any[]) => Promise<void>;
 export type ReadFile = (file: string) => Promise<any[]>;
 declare class CustomFileCpu implements FileCpu {
@@ -14,5 +15,6 @@ declare class CustomFileCpu implements FileCpu {
     findOne(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<any | false>;
     remove(file: string, one: boolean, arg: Search, context?: Context): Promise<boolean>;
     update(file: string, one: boolean, arg: Search, updater: Updater, context?: Context): Promise<boolean>;
+    transactions(file: string, transactions: Transaction[]): Promise<void>;
 }
 export default CustomFileCpu;

package/dist/file/customFileCpu.js

@@ -64,5 +64,8 @@ class CustomFileCpu {
         await this._writeFile(file, entries);
         return true;
     }
+    transactions(file, transactions) {
+        throw new Error("Method not implemented.");
+    }
 }
 export default CustomFileCpu;

package/dist/file/index.js

@@ -3,6 +3,7 @@ import remove from "./remove.js";
 import { find, findOne } from "./find.js";
 import { appendFileSync } from "fs";
 import { stringify } from "../format.js";
+import transactions from "./transactions.js";
 const vFileCpu = {
     add: async (file, data) => {
         const dataString = stringify(data);
@@ -11,6 +12,7 @@ const vFileCpu = {
     find,
     findOne,
     update,
-    remove
+    remove,
+    transactions
 };
 export default vFileCpu;

package/dist/file/transactions.d.ts

@@ -0,0 +1,3 @@
+import { Transaction } from "../types/transactions.js";
+declare function processTransactions(file: string, transactions: Transaction[]): Promise<void>;
+export default processTransactions;

package/dist/file/transactions.js

@@ -0,0 +1,119 @@
+import { existsSync, promises } from "fs";
+import { parse, stringify } from "../format.js";
+import genId from "../gen.js";
+import hasFieldsAdvanced from "../utils/hasFieldsAdvanced.js";
+import updateObjectAdvanced from "../utils/updateObject.js";
+import { createRL, pathRepair } from "./utils.js";
+async function processTransactions(file, transactions) {
+    file = pathRepair(file);
+    const tempFile = file + ".tmp";
+    const processedTransactions = transactions.map(t => ({
+        ...t,
+        applied: false
+    }));
+    if (existsSync(file)) {
+        await promises.copyFile(file, tempFile);
+    }
+    else {
+        await promises.writeFile(file, "");
+        await promises.writeFile(tempFile, "");
+    }
+    await promises.writeFile(file, "");
+    const rl = createRL(tempFile);
+    for await (const line of rl) {
+        const originalLine = line.trim();
+        if (!originalLine)
+            continue;
+        let data = parse(originalLine);
+        let shouldRemove = false;
+        let modified = false;
+        for (const transaction of processedTransactions) {
+            if (shouldRemove)
+                break;
+            let matches = false;
+            if (typeof transaction.search === 'function') {
+                matches = transaction.search(data, transaction.context || {}) || false;
+            }
+            else if (typeof transaction.search === 'object') {
+                matches = hasFieldsAdvanced(data, transaction.search);
+            }
+            if (!matches)
+                continue;
+            switch (transaction.type) {
+                case 'update':
+                    if (transaction.updater) {
+                        data = applyUpdater(data, transaction.updater, transaction.context || {});
+                        modified = true;
+                    }
+                    break;
+                case 'updateOne':
+                    if (!transaction.applied && transaction.updater) {
+                        data = applyUpdater(data, transaction.updater, transaction.context || {});
+                        modified = true;
+                        transaction.applied = true;
+                    }
+                    break;
+                case 'updateOneOrAdd':
+                    if (!transaction.applied && transaction.updater) {
+                        data = applyUpdater(data, transaction.updater, transaction.context || {});
+                        modified = true;
+                        transaction.applied = true;
+                    }
+                    break;
+                case 'remove':
+                    shouldRemove = true;
+                    modified = true;
+                    break;
+                case 'removeOne':
+                    if (!transaction.applied) {
+                        shouldRemove = true;
+                        modified = true;
+                        transaction.applied = true;
+                    }
+                    break;
+            }
+        }
+        if (!shouldRemove) {
+            const outputLine = modified ? await stringify(data) : originalLine;
+            await promises.appendFile(file, outputLine + "\n");
+        }
+    }
+    for (const transaction of processedTransactions) {
+        if (transaction.type === 'updateOneOrAdd' && !transaction.applied) {
+            const assignData = [];
+            if (typeof transaction.search === 'object' && !Array.isArray(transaction.search)) {
+                assignData.push(transaction.search);
+            }
+            if (transaction.updater && typeof transaction.updater === 'object' && !Array.isArray(transaction.updater)) {
+                const newData = {};
+                Object.keys(transaction.updater).filter(key => !key.startsWith('$')).forEach(key => newData[key] = transaction.updater[key]);
+                assignData.push(newData);
+            }
+            if (transaction.addArg && typeof transaction.addArg === 'object' && !Array.isArray(transaction.addArg)) {
+                assignData.push(transaction.addArg);
+            }
+            let newData = Object.assign({}, ...assignData);
+            if (transaction.updater && typeof transaction.updater === 'object' && !Array.isArray(transaction.updater)) {
+                newData = applyUpdater(newData, transaction.updater, transaction.context || {});
+            }
+            await add(file, newData, transaction.idGen !== false);
+        }
+    }
+    await promises.unlink(tempFile);
+}
+function applyUpdater(data, updater, context = {}) {
+    if (typeof updater === 'function') {
+        const result = updater(data, context);
+        return data === null ? result : (result || data);
+    }
+    if (typeof updater === 'object' && !Array.isArray(updater)) {
+        return updateObjectAdvanced(data || {}, updater);
+    }
+    return data;
+}
+async function add(file, data, idGen) {
+    if (idGen && !data._id)
+        data._id = genId();
+    await promises.appendFile(file, await stringify(data) + "\n");
+}
+export default processTransactions;

package/dist/index.d.ts

@@ -5,11 +5,18 @@ import GraphRemote from "./client/graph.js";
 import genId from "./gen.js";
 import Relation from "./relation.js";
 import CustomFileCpu from "./file/customFileCpu.js";
-import ValtheraMemory from "./memory.js";
-export { DataBase, DataBase as Valthera, Graph, DataBaseRemote, DataBaseRemote as ValtheraRemote, GraphRemote, Relation, genId, CustomFileCpu, ValtheraMemory, };
-import type Id from "./types/Id.js";
-import type { Arg, Search, Updater } from "./types/arg.js";
-import type { DbFindOpts, FindOpts, DbOpts } from "./types/options.js";
-import type Data from "./types/data.js";
-import type { SearchOptions } from "./types/searchOpts.js";
-export type { Id, Arg, Search, Updater, DbFindOpts, FindOpts, DbOpts, Data, SearchOptions, };
+import ValtheraMemory, { createMemoryValthera } from "./memory.js";
+export { DataBase as Valthera, Graph, DataBaseRemote as ValtheraRemote, GraphRemote, Relation, genId, CustomFileCpu, ValtheraMemory, createMemoryValthera };
+export type Id = import("./types/Id.js").Id;
+export declare namespace ValtheraTypes {
+    type Arg = import("./types/arg.js").Arg;
+    type Search = import("./types/arg.js").Search;
+    type Updater = import("./types/arg.js").Updater;
+    type DbFindOpts = import("./types/options.js").DbFindOpts;
+    type FindOpts = import("./types/options.js").FindOpts;
+    type DbOpts = import("./types/options.js").DbOpts;
+    type Data = import("./types/data.js").Data;
+    type SearchOptions = import("./types/searchOpts.js").SearchOptions;
+}
+import type { RelationTypes } from "./relation.js";
+export type { RelationTypes };

package/dist/index.js

@@ -5,5 +5,5 @@ import GraphRemote from "./client/graph.js";
 import genId from "./gen.js";
 import Relation from "./relation.js";
 import CustomFileCpu from "./file/customFileCpu.js";
-import ValtheraMemory from "./memory.js";
-export { DataBase, DataBase as Valthera, Graph, DataBaseRemote, DataBaseRemote as ValtheraRemote, GraphRemote, Relation, genId, CustomFileCpu, ValtheraMemory, };
+import ValtheraMemory, { createMemoryValthera } from "./memory.js";
+export { DataBase as Valthera, Graph, DataBaseRemote as ValtheraRemote, GraphRemote, Relation, genId, CustomFileCpu, ValtheraMemory, createMemoryValthera };

package/dist/memory.d.ts

@@ -1,4 +1,8 @@
 import DataBase from "./database.js";
+import Data from "./types/data.js";
 export default class ValtheraMemory extends DataBase {
     constructor(...args: any[]);
 }
+export declare function createMemoryValthera(data?: {
+    [key: string]: Data[];
+}): ValtheraMemory;

package/dist/memory.js

@@ -114,9 +114,25 @@ class MemoryAction {
     async removeCollection(collection) {
         this.memory.delete(collection);
     }
+    /**
+     * Executes a list of transactions on the specified database collection.
+     * @throws Error - Method not supported in memory.
+     */
+    transaction(collection, transactions) {
+        throw new Error("Method not supported in memory.");
+    }
 }
 export default class ValtheraMemory extends DataBase {
     constructor(...args) {
         super("", { dbAction: new MemoryAction() });
     }
 }
+export function createMemoryValthera(data) {
+    const db = new ValtheraMemory();
+    if (!data)
+        return db;
+    for (const collection of Object.keys(data)) {
+        db.dbAction.memory.set(collection, data[collection]);
+    }
+    return db;
+}

package/dist/relation.d.ts

@@ -1,34 +1,30 @@
 import DataBase from "./database.js";
 import { Search } from "./types/arg.js";
 import { DbFindOpts } from "./types/options.js";
-export interface Databases {
-    [key: string]: DataBase;
-}
-interface RelationConfig {
-    from: string;
-    localField: string;
-    foreignField: string;
-    as?: string;
-    multiple?: boolean;
+export declare namespace RelationTypes {
+    type Path = [string, string];
+    type FieldPath = string[];
+    interface DBS {
+        [key: string]: DataBase;
+    }
+    interface Relation {
+        [key: string]: RelationConfig;
+    }
+    interface RelationConfig {
+        path: Path;
+        pk?: string;
+        fk?: string;
+        as?: string;
+        select?: string[];
+        findOpts?: DbFindOpts;
+        type?: "1" | "1n" | "nm";
+        relations?: Relation;
+    }
 }
 declare class Relation {
-    private databases;
-    constructor(databases: Databases);
-    /**
-     * Resolves the relation path in format 'dbName.collectionName'.
-     */
-    private _resolvePath;
-    /**
-     * Processes relations for a single item.
-     */
-    private _processItemRelations;
-    /**
-     * Finds multiple items with relations.
-     */
-    find(path: string, search: Search, relations?: Record<string, RelationConfig>, options?: DbFindOpts): Promise<Record<string, any>[]>;
-    /**
-     * Finds a single item with relations.
-     */
-    findOne(path: string, search: Search, relations?: Record<string, RelationConfig>): Promise<Record<string, any> | null>;
+    dbs: RelationTypes.DBS;
+    constructor(dbs: RelationTypes.DBS);
+    findOne(path: RelationTypes.Path, search: Search, relations: RelationTypes.Relation, select: RelationTypes.FieldPath[]): Promise<any>;
+    find(path: RelationTypes.Path, search: Search, relations: RelationTypes.Relation, select: RelationTypes.FieldPath[], findOpts?: DbFindOpts): Promise<any[]>;
 }
 export default Relation;

package/dist/relation.js

@@ -1,62 +1,80 @@
-class Relation {
-    databases;
-    constructor(databases) {
-        this.databases = databases;
-    }
-    /**
-     * Resolves the relation path in format 'dbName.collectionName'.
-     */
-    _resolvePath(path) {
-        if (!path.includes(".")) {
-            throw new Error(`Invalid path format "${path}". Expected format 'dbName.collectionName'.`);
-        }
-        const sanitizedPath = path.replace(/\\\./g, "\uffff");
-        const [dbName, collectionName] = sanitizedPath.split(".", 2).map(part => part.replace(/\uffff/g, "."));
-        const db = this.databases[dbName];
-        if (!db) {
-            throw new Error(`Database "${dbName}" not found.`);
-        }
-        return { db, collection: collectionName };
-    }
-    /**
-     * Processes relations for a single item.
-     */
-    async _processItemRelations(item, relations) {
-        if (!item || typeof item !== "object")
-            return item;
-        const result = { ...item };
-        for (const [field, relationConfig] of Object.entries(relations)) {
-            if (!relationConfig.from || !relationConfig.localField || !relationConfig.foreignField) {
-                console.warn(`Skipping invalid relation configuration for field: "${field}"`);
+async function processRelations(dbs, cfg, data) {
+    for (const [key, relation] of Object.entries(cfg)) {
+        const { pk = "_id", fk = "_id", type = "1" } = relation;
+        if (type === "1") {
+            const db = dbs[relation.path[0]];
+            const collection = relation.path[1];
+            const item = await db.findOne(collection, { [fk]: data[pk] }, {}, { select: relation.select || null });
+            const field = relation.as || key;
+            if (!item) {
+                data[field] = null;
                 continue;
             }
-            try {
-                const { db, collection } = this._resolvePath(relationConfig.from);
-                const searchQuery = { [relationConfig.foreignField]: item[relationConfig.localField] };
-                const fetchFn = relationConfig.multiple ? db.find.bind(db) : db.findOne.bind(db);
-                result[relationConfig.as || field] = await fetchFn(collection, searchQuery) || null;
+            if (relation.relations) {
+                await processRelations(dbs, relation.relations, item);
+            }
+            data[field] = item;
+        }
+        else if (type === "1n") {
+            const db = dbs[relation.path[0]];
+            const collection = relation.path[1];
+            const items = await db.find(collection, { [fk]: data[pk] }, {}, relation.findOpts || {}, { select: relation.select || null });
+            const field = relation.as || key;
+            if (relation.relations) {
+                await Promise.all(items.map(item => processRelations(dbs, relation.relations, item)));
             }
-            catch (error) {
-                console.error(`Error processing relation for field "${field}":`, error);
+            data[field] = items;
+        }
+        else if (type === "nm") {
+            const db = dbs[relation.path[0]];
+            const collection = relation.path[1];
+            const items = await db.find(collection, {}, {}, {}, { select: relation.select || null });
+            const field = relation.as || key;
+            if (relation.relations) {
+                await Promise.all(items.map(item => processRelations(dbs, relation.relations, item)));
             }
+            data[field] = items;
         }
-        return result;
+        else {
+            throw new Error(`Unknown relation type: ${relation.type}`);
+        }
+    }
+}
+function selectDataSelf(data, select) {
+    if (!data)
+        return null;
+    if (select.length === 0)
+        return data;
+    if (Array.isArray(data))
+        return data.map(item => selectDataSelf(item, select));
+    return selectDataSelf(data[select[0]], select.slice(1));
+}
+function selectData(data, select) {
+    if (select.length === 0)
+        return data;
+    const newData = {};
+    for (const field of select) {
+        const key = field.map(f => f.replaceAll(".", "\\.")).join(".");
+        newData[key] = selectDataSelf(data, field);
+    }
+    return newData;
+}
+class Relation {
+    dbs;
+    constructor(dbs) {
+        this.dbs = dbs;
     }
-    /**
-     * Finds multiple items with relations.
-     */
-    async find(path, search, relations = {}, options = {}) {
-        const { db, collection } = this._resolvePath(path);
-        const items = await db.find(collection, search, {}, options);
-        return Promise.all(items.map(item => this._processItemRelations(item, relations)));
+    async findOne(path, search, relations, select) {
+        const db = this.dbs[path[0]];
+        const data = await db.findOne(path[1], search);
+        await processRelations(this.dbs, relations, data);
+        return selectData(data, select);
     }
-    /**
-     * Finds a single item with relations.
-     */
-    async findOne(path, search, relations = {}) {
-        const { db, collection } = this._resolvePath(path);
-        const item = await db.findOne(collection, search);
-        return item ? this._processItemRelations(item, relations) : null;
+    async find(path, search, relations, select, findOpts = {}) {
+        const db = this.dbs[path[0]];
+        const data = await db.find(path[1], search, {}, findOpts);
+        await Promise.all(data.map(item => processRelations(this.dbs, relations, item)));
+        return data.map(item => selectData(item, select));
     }
 }
 export default Relation;

package/dist/types/fileCpu.d.ts

@@ -1,6 +1,7 @@
 import { Search, Updater } from "./arg.js";
 import Data from "./data.js";
 import { FindOpts } from "./options.js";
+import { Transaction } from "./transactions.js";
 import { Context } from "./types.js";
 interface FileCpu {
     /**
@@ -47,5 +48,12 @@ interface FileCpu {
      * @returns A promise resolving to `true` if at least one entry was updated, otherwise `false`.
      */
     update(file: string, one: boolean, arg: Search, updater: Updater, context?: Context): Promise<boolean>;
+    /**
+     * Executes a list of transactions on the specified database collection.
+     * @param file The path to the file.
+     * @param transactions An array of transactions to execute.
+     * @returns A promise resolved when all transactions have been executed.
+     */
+    transactions(file: string, transactions: Transaction[]): Promise<void>;
 }
 export default FileCpu;

package/dist/types/transactions.d.ts

@@ -0,0 +1,10 @@
+import { Arg, Search, Updater } from "./arg.js";
+import { Context } from "./types.js";
+export interface Transaction {
+    type: 'update' | 'updateOne' | 'updateOneOrAdd' | 'remove' | 'removeOne';
+    search: Search;
+    updater?: Updater;
+    addArg?: Arg;
+    idGen?: boolean;
+    context?: Context;
+}

package/dist/types/transactions.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wxn0brp/db",
-	"version": "0.4.1",
+	"version": "0.5.1",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"description": "A simple file-based database management system with support for CRUD operations, custom queries, and graph structures.",