@wxn0brp/db 0.1.0 → 0.1.1

package/README.md

@@ -1,4 +1,4 @@
-# @wxn0brp/db
+# ValtheraDB (@wxn0brp/db)
 
 A lightweight file-based database management system that supports CRUD operations, custom queries, and graph structures.
 
@@ -20,7 +20,7 @@ import { DataBase, Graph, DataBaseRemote, GraphRemote, Relation, genId } from "@
 
 ## Documentation
 
-Website: [https://wxn0brp.github.io/database/](https://wxn0brp.github.io/database/)
+Website: [https://wxn0brp.github.io/ValtheraDB/](https://wxn0brp.github.io/ValtheraDB/)
 
 For detailed information, refer to the following resources:
 

package/dist/cjs/action.d.ts

@@ -3,6 +3,7 @@ import { DbFindOpts, DbOpts, FindOpts } from "./types/options.js";
 import { Context } from "./types/types.js";
 import { SearchOptions } from "./types/searchOpts.js";
 import Data from "./types/data.js";
+import FileCpu from "./types/fileCpu.js";
 /**
  * A class representing database actions on files.
  * @class
@@ -10,13 +11,14 @@ import Data from "./types/data.js";
 declare class dbActionC {
     folder: string;
     options: DbOpts;
+    fileCpu: FileCpu;
     /**
      * Creates a new instance of dbActionC.
      * @constructor
      * @param folder - The folder where database files are stored.
      * @param options - The options object.
      */
-    constructor(folder: string, options: DbOpts);
+    constructor(folder: string, options: DbOpts, fileCpu: FileCpu);
     _getCollectionPath(collection: string): string;
     /**
      * Get a list of available databases in the specified folder.

package/dist/cjs/action.js

@@ -4,9 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const gen_1 = __importDefault(require("./gen.js"));
-const format_1 = require("./format.js");
 const fs_1 = require("fs");
-const index_1 = require("./file/index.js");
 /**
  * A class representing database actions on files.
  * @class
@@ -14,18 +12,20 @@ const index_1 = require("./file/index.js");
 class dbActionC {
     folder;
     options;
+    fileCpu;
     /**
      * Creates a new instance of dbActionC.
      * @constructor
      * @param folder - The folder where database files are stored.
      * @param options - The options object.
      */
-    constructor(folder, options) {
+    constructor(folder, options, fileCpu) {
         this.folder = folder;
         this.options = {
             maxFileSize: 2 * 1024 * 1024, //2 MB
             ...options,
         };
+        this.fileCpu = fileCpu;
         if (!(0, fs_1.existsSync)(folder))
             (0, fs_1.mkdirSync)(folder, { recursive: true });
     }
@@ -69,8 +69,7 @@ class dbActionC {
         const file = cpath + getLastFile(cpath, this.options.maxFileSize);
         if (id_gen)
             arg._id = arg._id || (0, gen_1.default)();
-        const data = (0, format_1.stringify)(arg);
-        (0, fs_1.appendFileSync)(file, data + "\n");
+        await this.fileCpu.add(file, arg);
         return arg;
     }
     /**
@@ -87,7 +86,7 @@ class dbActionC {
         let datas = [];
         let totalEntries = 0;
         for (let f of files) {
-            let data = await (0, index_1.find)(cpath + f, arg, context, findOpts);
+            let data = await this.fileCpu.find(cpath + f, arg, context, findOpts);
             if (options.reverse)
                 data.reverse();
             if (options.max !== -1) {
@@ -114,7 +113,7 @@ class dbActionC {
         const cpath = this._getCollectionPath(collection);
         const files = getSortedFiles(cpath).map(f => f.f);
         for (let f of files) {
-            let data = await (0, index_1.findOne)(cpath + f, arg, context, findOpts);
+            let data = await this.fileCpu.findOne(cpath + f, arg, context, findOpts);
             if (data)
                 return data;
         }
@@ -125,28 +124,28 @@ class dbActionC {
      */
     async update(collection, arg, updater, context = {}) {
         this.checkCollection(collection);
-        return await (0, index_1.update)(this._getCollectionPath(collection), arg, updater, context);
+        return await this.fileCpu.update(this._getCollectionPath(collection), arg, updater, context);
     }
     /**
      * Update the first matching entry in the specified database based on search criteria and an updater function or object.
      */
     async updateOne(collection, arg, updater, context = {}) {
         this.checkCollection(collection);
-        return await (0, index_1.update)(this._getCollectionPath(collection), arg, updater, context, true);
+        return await this.fileCpu.update(this._getCollectionPath(collection), arg, updater, context, true);
     }
     /**
      * Remove entries from the specified database based on search criteria.
      */
     async remove(collection, arg, context = {}) {
         this.checkCollection(collection);
-        return await (0, index_1.remove)(this._getCollectionPath(collection), arg, context);
+        return await this.fileCpu.remove(this._getCollectionPath(collection), arg, context);
     }
     /**
      * Remove the first matching entry from the specified database based on search criteria.
      */
     async removeOne(collection, arg, context = {}) {
         this.checkCollection(collection);
-        return await (0, index_1.remove)(this._getCollectionPath(collection), arg, context, true);
+        return await this.fileCpu.remove(this._getCollectionPath(collection), arg, context, true);
     }
     /**
      * Removes a database collection from the file system.

package/dist/cjs/database.d.ts

@@ -5,6 +5,7 @@ import { DbFindOpts, DbOpts, FindOpts } from "./types/options.js";
 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";
 /**
  * Represents a database management class for performing CRUD operations.
  * @class
@@ -12,7 +13,7 @@ import { Context } from "./types/types.js";
 declare class DataBase {
     dbAction: dbActionC;
     executor: executorC;
-    constructor(folder: string, options?: DbOpts);
+    constructor(folder: string, options?: DbOpts, fileCpu?: FileCpu);
     /**
      * Create a new instance of a CollectionManager class.
      */

package/dist/cjs/database.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const action_1 = __importDefault(require("./action.js"));
 const executor_1 = __importDefault(require("./executor.js"));
 const CollectionManager_1 = __importDefault(require("./CollectionManager.js"));
+const file_1 = __importDefault(require("./file/index.js"));
 /**
  * Represents a database management class for performing CRUD operations.
  * @class
@@ -13,8 +14,10 @@ const CollectionManager_1 = __importDefault(require("./CollectionManager.js"));
 class DataBase {
     dbAction;
     executor;
-    constructor(folder, options = {}) {
-        this.dbAction = new action_1.default(folder, options);
+    constructor(folder, options = {}, fileCpu) {
+        if (!fileCpu)
+            fileCpu = file_1.default;
+        this.dbAction = new action_1.default(folder, options, fileCpu);
         this.executor = new executor_1.default();
     }
     /**

package/dist/cjs/file/customFileCpu.d.ts

@@ -0,0 +1,19 @@
+import { Context } from "vm";
+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";
+type WriteFile = (file: string, data: any[]) => Promise<void>;
+type ReadFile = (file: string) => Promise<any[]>;
+declare class CustomFileCpu implements FileCpu {
+    _readFile: ReadFile;
+    _writeFile: WriteFile;
+    constructor(readFile: ReadFile, writeFile: WriteFile);
+    add(file: string, data: Data): Promise<void>;
+    addMany(file: string, data: Data[]): Promise<void>;
+    find(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<any[] | false>;
+    findOne(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<any | false>;
+    remove(cpath: string, arg: Search, context?: Context, one?: boolean): Promise<boolean>;
+    update(cpath: string, arg: Search, updater: Updater, context?: Context, one?: boolean): Promise<boolean>;
+}
+export default CustomFileCpu;

package/dist/cjs/file/customFileCpu.js

@@ -0,0 +1,79 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const hasFieldsAdvanced_1 = __importDefault(require("../utils/hasFieldsAdvanced.js"));
+const updateFindObject_1 = __importDefault(require("../utils/updateFindObject.js"));
+const utils_1 = require("./utils.js");
+class CustomFileCpu {
+    _readFile;
+    _writeFile;
+    constructor(readFile, writeFile) {
+        this._readFile = readFile;
+        this._writeFile = writeFile;
+    }
+    async add(file, data) {
+        file = (0, utils_1.pathRepair)(file);
+        let entries = await this._readFile(file);
+        entries.push(data);
+        await this._writeFile(file, entries);
+    }
+    async addMany(file, data) {
+        file = (0, utils_1.pathRepair)(file);
+        let entries = await this._readFile(file);
+        entries = entries.concat(data);
+        await this._writeFile(file, entries);
+    }
+    async find(file, arg, context = {}, findOpts = {}) {
+        file = (0, utils_1.pathRepair)(file);
+        const entries = await this._readFile(file);
+        const results = entries.filter(entry => typeof arg === "function" ? arg(entry, context) : (0, hasFieldsAdvanced_1.default)(entry, arg));
+        return results.length ? results.map(res => (0, updateFindObject_1.default)(res, findOpts)) : false;
+    }
+    async findOne(file, arg, context = {}, findOpts = {}) {
+        file = (0, utils_1.pathRepair)(file);
+        const entries = await this._readFile(file);
+        const result = entries.find(entry => typeof arg === "function" ? arg(entry, context) : (0, hasFieldsAdvanced_1.default)(entry, arg));
+        return result ? (0, updateFindObject_1.default)(result, findOpts) : false;
+    }
+    async remove(cpath, arg, context = {}, one = false) {
+        const file = (0, utils_1.pathRepair)(cpath);
+        let entries = await this._readFile(file);
+        let removed = false;
+        entries = entries.filter(entry => {
+            if (removed && one)
+                return true;
+            let match = typeof arg === "function" ? arg(entry, context) : (0, hasFieldsAdvanced_1.default)(entry, arg);
+            if (match) {
+                removed = true;
+                return false;
+            }
+            return true;
+        });
+        if (!removed)
+            return false;
+        await this._writeFile(file, entries);
+        return true;
+    }
+    async update(cpath, arg, updater, context = {}, one = false) {
+        const file = (0, utils_1.pathRepair)(cpath);
+        let entries = await this._readFile(file);
+        let updated = false;
+        entries = entries.map(entry => {
+            if (updated && one)
+                return entry;
+            let match = typeof arg === "function" ? arg(entry, context) : (0, hasFieldsAdvanced_1.default)(entry, arg);
+            if (match) {
+                updated = true;
+                return typeof updater === "function" ? updater(entry, context) : { ...entry, ...updater };
+            }
+            return entry;
+        });
+        if (!updated)
+            return false;
+        await this._writeFile(file, entries);
+        return true;
+    }
+}
+exports.default = CustomFileCpu;

package/dist/cjs/file/find.d.ts

@@ -4,8 +4,8 @@ import { FindOpts } from "../types/options.js";
 /**
  * Asynchronously finds entries in a file based on search criteria.
  */
-export declare function find(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<unknown>;
+export declare function find(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<any[] | false>;
 /**
  * Asynchronously finds one entry in a file based on search criteria.
  */
-export declare function findOne(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<unknown>;
+export declare function findOne(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<any | false>;

package/dist/cjs/file/index.d.ts

@@ -1,3 +1,3 @@
-export { default as update } from "./update.js";
-export { default as remove } from "./remove.js";
-export * from "./find.js";
+import FileCpu from "../types/fileCpu.js";
+declare const vFileCpu: FileCpu;
+export default vFileCpu;

package/dist/cjs/file/index.js

@@ -1,25 +1,21 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.remove = exports.update = void 0;
-var update_1 = require("./update.js");
-Object.defineProperty(exports, "update", { enumerable: true, get: function () { return __importDefault(update_1).default; } });
-var remove_1 = require("./remove.js");
-Object.defineProperty(exports, "remove", { enumerable: true, get: function () { return __importDefault(remove_1).default; } });
-__exportStar(require("./find.js"), exports);
+const update_1 = __importDefault(require("./update.js"));
+const remove_1 = __importDefault(require("./remove.js"));
+const find_1 = require("./find.js");
+const fs_1 = require("fs");
+const format_1 = require("../format.js");
+const vFileCpu = {
+    add: async (file, data) => {
+        const dataString = (0, format_1.stringify)(data);
+        (0, fs_1.appendFileSync)(file, dataString + "\n");
+    },
+    find: find_1.find,
+    findOne: find_1.findOne,
+    update: update_1.default,
+    remove: remove_1.default
+};
+exports.default = vFileCpu;

package/dist/cjs/index.d.ts

@@ -4,10 +4,11 @@ import DataBaseRemote from "./client/database.js";
 import GraphRemote from "./client/graph.js";
 import genId from "./gen.js";
 import Relation from "./relation.js";
-export { DataBase, Graph, DataBaseRemote, GraphRemote, Relation, genId };
+import CustomFileCpu from "./file/customFileCpu.js";
+export { DataBase, Graph, DataBaseRemote, GraphRemote, Relation, genId, CustomFileCpu, };
 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 };
+export type { Id, Arg, Search, Updater, DbFindOpts, FindOpts, DbOpts, Data, SearchOptions, };

package/dist/cjs/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.genId = exports.Relation = exports.GraphRemote = exports.DataBaseRemote = exports.Graph = exports.DataBase = void 0;
+exports.CustomFileCpu = exports.genId = exports.Relation = exports.GraphRemote = exports.DataBaseRemote = exports.Graph = exports.DataBase = void 0;
 const database_1 = __importDefault(require("./database.js"));
 exports.DataBase = database_1.default;
 const graph_1 = __importDefault(require("./graph.js"));
@@ -16,3 +16,5 @@ const gen_1 = __importDefault(require("./gen.js"));
 exports.genId = gen_1.default;
 const relation_1 = __importDefault(require("./relation.js"));
 exports.Relation = relation_1.default;
+const customFileCpu_1 = __importDefault(require("./file/customFileCpu.js"));
+exports.CustomFileCpu = customFileCpu_1.default;

package/dist/cjs/types/fileCpu.d.ts

@@ -0,0 +1,51 @@
+import { Search, Updater } from "./arg.js";
+import Data from "./data.js";
+import { FindOpts } from "./options.js";
+import { Context } from "./types.js";
+interface FileCpu {
+    /**
+     * Asynchronously adds an entry to a file.
+     * @param file The path to the file.
+     * @param data The data to add.
+     * @returns A promise resolving to `void`.
+     */
+    add(file: string, data: Data): Promise<void>;
+    /**
+     * Asynchronously finds multiple entries in a file based on search criteria.
+     * @param file The path to the file.
+     * @param arg The search criteria.
+     * @param context Additional context for the search.
+     * @param findOpts Additional options for searching.
+     * @returns A promise resolving to an array of found entries, or `false` if the file does not exist.
+     */
+    find(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<any[] | false>;
+    /**
+     * Asynchronously finds one entry in a file based on search criteria.
+     * @param file The path to the file.
+     * @param arg The search criteria.
+     * @param context Additional context for the search.
+     * @param findOpts Additional options for searching.
+     * @returns A promise resolving to the found entry or `false` if not found.
+     */
+    findOne(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<any | false>;
+    /**
+   * Asynchronously removes entries from a file based on search criteria.
+   * @param cpath The path to the directory containing the files.
+   * @param arg The search criteria.
+   * @param context Additional context for the operation.
+   * @param one If `true`, removes only the first matching entry.
+   * @returns A promise resolving to `true` if at least one entry was removed, otherwise `false`.
+   */
+    remove(cpath: string, arg: Search, context?: Context, one?: boolean): Promise<boolean>;
+    /**
+     * Asynchronously updates entries in a file based on search criteria and an updater function or object.
+     * @param cpath The path to the directory containing the files.
+     * @param arg The search criteria.
+     * @param updater The updater function or object.
+     * @param context Additional context for the operation.
+     * @param one If `true`, updates only the first matching entry.
+     * @returns A promise resolving to `true` if at least one entry was updated, otherwise `false`.
+     */
+    update(cpath: string, arg: Search, updater: Updater, context?: Context, one?: boolean): Promise<boolean>;
+}
+export default FileCpu;

package/dist/cjs/types/fileCpu.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/esm/action.d.ts

@@ -3,6 +3,7 @@ import { DbFindOpts, DbOpts, FindOpts } from "./types/options.js";
 import { Context } from "./types/types.js";
 import { SearchOptions } from "./types/searchOpts.js";
 import Data from "./types/data.js";
+import FileCpu from "./types/fileCpu.js";
 /**
  * A class representing database actions on files.
  * @class
@@ -10,13 +11,14 @@ import Data from "./types/data.js";
 declare class dbActionC {
     folder: string;
     options: DbOpts;
+    fileCpu: FileCpu;
     /**
      * Creates a new instance of dbActionC.
      * @constructor
      * @param folder - The folder where database files are stored.
      * @param options - The options object.
      */
-    constructor(folder: string, options: DbOpts);
+    constructor(folder: string, options: DbOpts, fileCpu: FileCpu);
     _getCollectionPath(collection: string): string;
     /**
      * Get a list of available databases in the specified folder.

package/dist/esm/action.js

@@ -1,7 +1,5 @@
 import gen from "./gen.js";
-import { stringify } from "./format.js";
-import { existsSync, mkdirSync, readdirSync, appendFileSync, rmSync, writeFileSync, statSync } from "fs";
-import { find as _find, findOne as _findOne, update as _update, remove as _remove } from "./file/index.js";
+import { existsSync, mkdirSync, readdirSync, rmSync, writeFileSync, statSync } from "fs";
 /**
  * A class representing database actions on files.
  * @class
@@ -9,18 +7,20 @@ import { find as _find, findOne as _findOne, update as _update, remove as _remov
 class dbActionC {
     folder;
     options;
+    fileCpu;
     /**
      * Creates a new instance of dbActionC.
      * @constructor
      * @param folder - The folder where database files are stored.
      * @param options - The options object.
      */
-    constructor(folder, options) {
+    constructor(folder, options, fileCpu) {
         this.folder = folder;
         this.options = {
             maxFileSize: 2 * 1024 * 1024, //2 MB
             ...options,
         };
+        this.fileCpu = fileCpu;
         if (!existsSync(folder))
             mkdirSync(folder, { recursive: true });
     }
@@ -64,8 +64,7 @@ class dbActionC {
         const file = cpath + getLastFile(cpath, this.options.maxFileSize);
         if (id_gen)
             arg._id = arg._id || gen();
-        const data = stringify(arg);
-        appendFileSync(file, data + "\n");
+        await this.fileCpu.add(file, arg);
         return arg;
     }
     /**
@@ -82,7 +81,7 @@ class dbActionC {
         let datas = [];
         let totalEntries = 0;
         for (let f of files) {
-            let data = await _find(cpath + f, arg, context, findOpts);
+            let data = await this.fileCpu.find(cpath + f, arg, context, findOpts);
             if (options.reverse)
                 data.reverse();
             if (options.max !== -1) {
@@ -109,7 +108,7 @@ class dbActionC {
         const cpath = this._getCollectionPath(collection);
         const files = getSortedFiles(cpath).map(f => f.f);
         for (let f of files) {
-            let data = await _findOne(cpath + f, arg, context, findOpts);
+            let data = await this.fileCpu.findOne(cpath + f, arg, context, findOpts);
             if (data)
                 return data;
         }
@@ -120,28 +119,28 @@ class dbActionC {
      */
     async update(collection, arg, updater, context = {}) {
         this.checkCollection(collection);
-        return await _update(this._getCollectionPath(collection), arg, updater, context);
+        return await this.fileCpu.update(this._getCollectionPath(collection), arg, updater, context);
     }
     /**
      * Update the first matching entry in the specified database based on search criteria and an updater function or object.
      */
     async updateOne(collection, arg, updater, context = {}) {
         this.checkCollection(collection);
-        return await _update(this._getCollectionPath(collection), arg, updater, context, true);
+        return await this.fileCpu.update(this._getCollectionPath(collection), arg, updater, context, true);
     }
     /**
      * Remove entries from the specified database based on search criteria.
      */
     async remove(collection, arg, context = {}) {
         this.checkCollection(collection);
-        return await _remove(this._getCollectionPath(collection), arg, context);
+        return await this.fileCpu.remove(this._getCollectionPath(collection), arg, context);
     }
     /**
      * Remove the first matching entry from the specified database based on search criteria.
      */
     async removeOne(collection, arg, context = {}) {
         this.checkCollection(collection);
-        return await _remove(this._getCollectionPath(collection), arg, context, true);
+        return await this.fileCpu.remove(this._getCollectionPath(collection), arg, context, true);
     }
     /**
      * Removes a database collection from the file system.

package/dist/esm/database.d.ts

@@ -5,6 +5,7 @@ import { DbFindOpts, DbOpts, FindOpts } from "./types/options.js";
 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";
 /**
  * Represents a database management class for performing CRUD operations.
  * @class
@@ -12,7 +13,7 @@ import { Context } from "./types/types.js";
 declare class DataBase {
     dbAction: dbActionC;
     executor: executorC;
-    constructor(folder: string, options?: DbOpts);
+    constructor(folder: string, options?: DbOpts, fileCpu?: FileCpu);
     /**
      * Create a new instance of a CollectionManager class.
      */

package/dist/esm/database.js

@@ -1,6 +1,7 @@
 import dbActionC from "./action.js";
 import executorC from "./executor.js";
 import CollectionManager from "./CollectionManager.js";
+import vFileCpu from "./file/index.js";
 /**
  * Represents a database management class for performing CRUD operations.
  * @class
@@ -8,8 +9,10 @@ import CollectionManager from "./CollectionManager.js";
 class DataBase {
     dbAction;
     executor;
-    constructor(folder, options = {}) {
-        this.dbAction = new dbActionC(folder, options);
+    constructor(folder, options = {}, fileCpu) {
+        if (!fileCpu)
+            fileCpu = vFileCpu;
+        this.dbAction = new dbActionC(folder, options, fileCpu);
         this.executor = new executorC();
     }
     /**

package/dist/esm/file/customFileCpu.d.ts

@@ -0,0 +1,19 @@
+import { Context } from "vm";
+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";
+type WriteFile = (file: string, data: any[]) => Promise<void>;
+type ReadFile = (file: string) => Promise<any[]>;
+declare class CustomFileCpu implements FileCpu {
+    _readFile: ReadFile;
+    _writeFile: WriteFile;
+    constructor(readFile: ReadFile, writeFile: WriteFile);
+    add(file: string, data: Data): Promise<void>;
+    addMany(file: string, data: Data[]): Promise<void>;
+    find(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<any[] | false>;
+    findOne(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<any | false>;
+    remove(cpath: string, arg: Search, context?: Context, one?: boolean): Promise<boolean>;
+    update(cpath: string, arg: Search, updater: Updater, context?: Context, one?: boolean): Promise<boolean>;
+}
+export default CustomFileCpu;

package/dist/esm/file/customFileCpu.js

@@ -0,0 +1,74 @@
+import hasFieldsAdvanced from "../utils/hasFieldsAdvanced.js";
+import updateFindObject from "../utils/updateFindObject.js";
+import { pathRepair } from "./utils.js";
+class CustomFileCpu {
+    _readFile;
+    _writeFile;
+    constructor(readFile, writeFile) {
+        this._readFile = readFile;
+        this._writeFile = writeFile;
+    }
+    async add(file, data) {
+        file = pathRepair(file);
+        let entries = await this._readFile(file);
+        entries.push(data);
+        await this._writeFile(file, entries);
+    }
+    async addMany(file, data) {
+        file = pathRepair(file);
+        let entries = await this._readFile(file);
+        entries = entries.concat(data);
+        await this._writeFile(file, entries);
+    }
+    async find(file, arg, context = {}, findOpts = {}) {
+        file = pathRepair(file);
+        const entries = await this._readFile(file);
+        const results = entries.filter(entry => typeof arg === "function" ? arg(entry, context) : hasFieldsAdvanced(entry, arg));
+        return results.length ? results.map(res => updateFindObject(res, findOpts)) : false;
+    }
+    async findOne(file, arg, context = {}, findOpts = {}) {
+        file = pathRepair(file);
+        const entries = await this._readFile(file);
+        const result = entries.find(entry => typeof arg === "function" ? arg(entry, context) : hasFieldsAdvanced(entry, arg));
+        return result ? updateFindObject(result, findOpts) : false;
+    }
+    async remove(cpath, arg, context = {}, one = false) {
+        const file = pathRepair(cpath);
+        let entries = await this._readFile(file);
+        let removed = false;
+        entries = entries.filter(entry => {
+            if (removed && one)
+                return true;
+            let match = typeof arg === "function" ? arg(entry, context) : hasFieldsAdvanced(entry, arg);
+            if (match) {
+                removed = true;
+                return false;
+            }
+            return true;
+        });
+        if (!removed)
+            return false;
+        await this._writeFile(file, entries);
+        return true;
+    }
+    async update(cpath, arg, updater, context = {}, one = false) {
+        const file = pathRepair(cpath);
+        let entries = await this._readFile(file);
+        let updated = false;
+        entries = entries.map(entry => {
+            if (updated && one)
+                return entry;
+            let match = typeof arg === "function" ? arg(entry, context) : hasFieldsAdvanced(entry, arg);
+            if (match) {
+                updated = true;
+                return typeof updater === "function" ? updater(entry, context) : { ...entry, ...updater };
+            }
+            return entry;
+        });
+        if (!updated)
+            return false;
+        await this._writeFile(file, entries);
+        return true;
+    }
+}
+export default CustomFileCpu;

package/dist/esm/file/find.d.ts

@@ -4,8 +4,8 @@ import { FindOpts } from "../types/options.js";
 /**
  * Asynchronously finds entries in a file based on search criteria.
  */
-export declare function find(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<unknown>;
+export declare function find(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<any[] | false>;
 /**
  * Asynchronously finds one entry in a file based on search criteria.
  */
-export declare function findOne(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<unknown>;
+export declare function findOne(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<any | false>;

package/dist/esm/file/index.d.ts

@@ -1,3 +1,3 @@
-export { default as update } from "./update.js";
-export { default as remove } from "./remove.js";
-export * from "./find.js";
+import FileCpu from "../types/fileCpu.js";
+declare const vFileCpu: FileCpu;
+export default vFileCpu;

package/dist/esm/file/index.js

@@ -1,3 +1,16 @@
-export { default as update } from "./update.js";
-export { default as remove } from "./remove.js";
-export * from "./find.js";
+import update from "./update.js";
+import remove from "./remove.js";
+import { find, findOne } from "./find.js";
+import { appendFileSync } from "fs";
+import { stringify } from "../format.js";
+const vFileCpu = {
+    add: async (file, data) => {
+        const dataString = stringify(data);
+        appendFileSync(file, dataString + "\n");
+    },
+    find,
+    findOne,
+    update,
+    remove
+};
+export default vFileCpu;

package/dist/esm/index.d.ts

@@ -4,10 +4,11 @@ import DataBaseRemote from "./client/database.js";
 import GraphRemote from "./client/graph.js";
 import genId from "./gen.js";
 import Relation from "./relation.js";
-export { DataBase, Graph, DataBaseRemote, GraphRemote, Relation, genId };
+import CustomFileCpu from "./file/customFileCpu.js";
+export { DataBase, Graph, DataBaseRemote, GraphRemote, Relation, genId, CustomFileCpu, };
 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 };
+export type { Id, Arg, Search, Updater, DbFindOpts, FindOpts, DbOpts, Data, SearchOptions, };

package/dist/esm/index.js

@@ -4,4 +4,5 @@ import DataBaseRemote from "./client/database.js";
 import GraphRemote from "./client/graph.js";
 import genId from "./gen.js";
 import Relation from "./relation.js";
-export { DataBase, Graph, DataBaseRemote, GraphRemote, Relation, genId };
+import CustomFileCpu from "./file/customFileCpu.js";
+export { DataBase, Graph, DataBaseRemote, GraphRemote, Relation, genId, CustomFileCpu, };

package/dist/esm/types/fileCpu.d.ts

@@ -0,0 +1,51 @@
+import { Search, Updater } from "./arg.js";
+import Data from "./data.js";
+import { FindOpts } from "./options.js";
+import { Context } from "./types.js";
+interface FileCpu {
+    /**
+     * Asynchronously adds an entry to a file.
+     * @param file The path to the file.
+     * @param data The data to add.
+     * @returns A promise resolving to `void`.
+     */
+    add(file: string, data: Data): Promise<void>;
+    /**
+     * Asynchronously finds multiple entries in a file based on search criteria.
+     * @param file The path to the file.
+     * @param arg The search criteria.
+     * @param context Additional context for the search.
+     * @param findOpts Additional options for searching.
+     * @returns A promise resolving to an array of found entries, or `false` if the file does not exist.
+     */
+    find(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<any[] | false>;
+    /**
+     * Asynchronously finds one entry in a file based on search criteria.
+     * @param file The path to the file.
+     * @param arg The search criteria.
+     * @param context Additional context for the search.
+     * @param findOpts Additional options for searching.
+     * @returns A promise resolving to the found entry or `false` if not found.
+     */
+    findOne(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<any | false>;
+    /**
+   * Asynchronously removes entries from a file based on search criteria.
+   * @param cpath The path to the directory containing the files.
+   * @param arg The search criteria.
+   * @param context Additional context for the operation.
+   * @param one If `true`, removes only the first matching entry.
+   * @returns A promise resolving to `true` if at least one entry was removed, otherwise `false`.
+   */
+    remove(cpath: string, arg: Search, context?: Context, one?: boolean): Promise<boolean>;
+    /**
+     * Asynchronously updates entries in a file based on search criteria and an updater function or object.
+     * @param cpath The path to the directory containing the files.
+     * @param arg The search criteria.
+     * @param updater The updater function or object.
+     * @param context Additional context for the operation.
+     * @param one If `true`, updates only the first matching entry.
+     * @returns A promise resolving to `true` if at least one entry was updated, otherwise `false`.
+     */
+    update(cpath: string, arg: Search, updater: Updater, context?: Context, one?: boolean): Promise<boolean>;
+}
+export default FileCpu;

package/dist/esm/types/fileCpu.js

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

package/package.json

@@ -1,13 +1,13 @@
 {
 	"name": "@wxn0brp/db",
-	"version": "0.1.0",
+	"version": "0.1.1",
 	"main": "dist/esm/index.js",
 	"types": "dist/esm/index.d.ts",
 	"description": "A simple file-based database management system with support for CRUD operations, custom queries, and graph structures.",
-	"homepage": "https://github.com/wxn0brP/database",
+	"homepage": "https://github.com/wxn0brP/ValtheraDB",
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/wxn0brP/database.git"
+		"url": "https://github.com/wxn0brP/ValtheraDB.git"
 	},
 	"keywords": [
 		"database",