@wxn0brp/db 0.0.8 → 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/CollectionManager.d.ts

@@ -39,6 +39,6 @@ declare class CollectionManager {
     /**
      * Asynchronously updates one entry in a database or adds a new one if it doesn't exist.
      */
-    updateOneOrAdd(search: Search, arg: Search, add_arg?: Arg, context?: Context, id_gen?: boolean): Promise<boolean>;
+    updateOneOrAdd(search: Search, updater: Updater, add_arg?: Arg, context?: Context, id_gen?: boolean): Promise<boolean>;
 }
 export default CollectionManager;

package/dist/cjs/CollectionManager.js

@@ -52,8 +52,8 @@ class CollectionManager {
     /**
      * Asynchronously updates one entry in a database or adds a new one if it doesn't exist.
      */
-    async updateOneOrAdd(search, arg, add_arg = {}, context = {}, id_gen = true) {
-        return await this.db.updateOneOrAdd(this.collection, search, arg, add_arg, context, id_gen);
+    async updateOneOrAdd(search, updater, add_arg = {}, context = {}, id_gen = true) {
+        return await this.db.updateOneOrAdd(this.collection, search, updater, add_arg, context, id_gen);
     }
 }
 exports.default = CollectionManager;

package/dist/cjs/action.d.ts

@@ -1,8 +1,9 @@
 import { Arg, Search, Updater } from "./types/arg.js";
 import { DbFindOpts, DbOpts, FindOpts } from "./types/options.js";
-import { Context } from "./types/types";
+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

@@ -3,10 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+const gen_1 = __importDefault(require("./gen.js"));
 const fs_1 = require("fs");
-const gen_js_1 = __importDefault(require("./gen.js"));
-const format_js_1 = require("./format.js");
-const index_js_1 = require("./file/index.js");
 /**
  * A class representing database actions on files.
  * @class
@@ -14,18 +12,20 @@ const index_js_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 });
     }
@@ -68,9 +68,8 @@ class dbActionC {
         const cpath = this._getCollectionPath(collection);
         const file = cpath + getLastFile(cpath, this.options.maxFileSize);
         if (id_gen)
-            arg._id = arg._id || (0, gen_js_1.default)();
-        const data = (0, format_js_1.stringify)(arg);
-        (0, fs_1.appendFileSync)(file, data + "\n");
+            arg._id = arg._id || (0, gen_1.default)();
+        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_js_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_js_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_js_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_js_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_js_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_js_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/client/database.d.ts

@@ -1,8 +1,8 @@
 import CollectionManager from "../CollectionManager.js";
-import { Remote, RequestData } from "./remote.js";
-import { Arg, Search, Updater } from "../types/arg";
+import { Remote } from "./remote.js";
+import { Arg, Search, Updater } from "../types/arg.js";
 import { DbFindOpts, FindOpts } from "../types/options.js";
-import { Context } from "../types/types";
+import { Context } from "../types/types.js";
 import Data from "../types/data.js";
 /**
  * Represents a database management class for performing CRUD operations.
@@ -15,7 +15,7 @@ declare class DataBaseRemote {
     /**
      * Make a request to the remote database.
      */
-    _request<T>(type: string, data: RequestData): Promise<T>;
+    _request<T>(type: string, params?: any[]): Promise<T>;
     /**
      * Create a new instance of a CollectionManager class.
      */

package/dist/cjs/client/database.js

@@ -3,9 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const got_1 = __importDefault(require("got"));
-const CollectionManager_js_1 = __importDefault(require("../CollectionManager.js"));
-const function_js_1 = __importDefault(require("./function.js"));
+const ky_1 = __importDefault(require("ky"));
+const CollectionManager_1 = __importDefault(require("../CollectionManager.js"));
+const function_1 = __importDefault(require("./function.js"));
 /**
  * Represents a database management class for performing CRUD operations.
  * Uses a remote database.
@@ -19,127 +19,101 @@ class DataBaseRemote {
     /**
      * Make a request to the remote database.
      */
-    async _request(type, data) {
-        data.db = this.remote.name;
-        const processed = (0, function_js_1.default)(data);
-        data = {
-            keys: processed.keys,
-            ...processed.data
+    async _request(type, params = []) {
+        const processed = (0, function_1.default)(params);
+        const data = {
+            db: this.remote.name,
+            params: processed.data,
+            keys: processed.keys
         };
-        const res = await got_1.default.post(this.remote.url + "/db/database/" + type, {
-            // @ts-ignore: Some jerk can't do the types correctly.
-            body: data,
+        const res = await ky_1.default.post(this.remote.url + "/db/" + type, {
+            json: data,
             headers: {
                 "Authorization": this.remote.auth
             },
-            json: true,
-            responseType: "json"
-        });
-        if (res.body.err)
-            throw new Error(res.body.msg);
-        return res.body.result;
+            throwHttpErrors: false
+        }).json();
+        if (res.err)
+            throw new Error(res.msg);
+        return res.result;
     }
     /**
      * Create a new instance of a CollectionManager class.
      */
     c(collection) {
-        return new CollectionManager_js_1.default(this, collection);
+        return new CollectionManager_1.default(this, collection);
     }
     /**
      * Get the names of all available databases.
      */
     async getCollections() {
-        return await this._request("getCollections", {});
+        return await this._request("getCollections", []);
     }
     /**
      * Check and create the specified collection if it doesn't exist.
      */
     async checkCollection(collection) {
-        return await this._request("checkCollection", { collection });
+        return await this._request("checkCollection", [collection]);
     }
     /**
      * Check if a collection exists.
      */
     async issetCollection(collection) {
-        return await this._request("issetCollection", { collection });
+        return await this._request("issetCollection", [collection]);
     }
     /**
      * Add data to a database.
      */
     async add(collection, data, id_gen = true) {
-        return await this._request("add", { collection, data, id_gen });
+        return await this._request("add", [collection, data, id_gen]);
     }
     /**
      * Find data in a database.
      */
     async find(collection, search, context = {}, options = {}, findOpts = {}) {
-        const searchStr = typeof search === "function" ? search.toString() : search;
-        const findOptsRemote = {};
-        if (findOpts.select)
-            findOptsRemote.select = findOpts.select;
-        if (findOpts.exclude)
-            findOptsRemote.exclude = findOpts.exclude;
-        if (findOpts.transform)
-            findOptsRemote.transform = findOpts.transform.toString();
-        return await this._request("find", { collection, search: searchStr, options, context, findOpts });
+        return await this._request("find", [collection, search, context, options, findOpts]);
     }
     /**
      * Find one data entry in a database.
      */
     async findOne(collection, search, context = {}, findOpts = {}) {
-        const searchStr = typeof search === "function" ? search.toString() : search;
-        const findOptsRemote = {};
-        if (findOpts.select)
-            findOptsRemote.select = findOpts.select;
-        if (findOpts.exclude)
-            findOptsRemote.exclude = findOpts.exclude;
-        if (findOpts.transform)
-            findOptsRemote.transform = findOpts.transform.toString();
-        return await this._request("findOne", { collection, search: searchStr, context, findOpts });
+        return await this._request("findOne", [collection, search, context, findOpts]);
     }
     /**
      * Update data in a database.
      */
     async update(collection, search, updater, context = {}) {
-        const searchStr = typeof search === "function" ? search.toString() : search;
-        const argStr = typeof updater === "function" ? updater.toString() : updater;
-        return await this._request("update", { collection, search: searchStr, arg: argStr, context });
+        return await this._request("update", [collection, search, updater, context]);
     }
     /**
      * Update one data entry in a database.
      */
     async updateOne(collection, search, updater, context = {}) {
-        const searchStr = typeof search === "function" ? search.toString() : search;
-        const argStr = typeof updater === "function" ? updater.toString() : updater;
-        return await this._request("updateOne", { collection, search: searchStr, arg: argStr, context });
+        return await this._request("updateOne", [collection, search, updater, context]);
     }
     /**
      * Remove data from a database.
      */
     async remove(collection, search, context = {}) {
-        const searchStr = typeof search === "function" ? search.toString() : search;
-        return await this._request("remove", { collection, search: searchStr, context });
+        return await this._request("remove", [collection, search, context]);
     }
     /**
      * Remove one data entry from a database.
      */
     async removeOne(collection, search, context = {}) {
-        const searchStr = typeof search === "function" ? search.toString() : search;
-        return await this._request("removeOne", { collection, search: searchStr, context });
+        return await this._request("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, arg, add_arg = {}, context = {}, id_gen = true) {
-        const searchStr = typeof search === "function" ? search.toString() : search;
-        const argStr = typeof arg === "function" ? arg.toString() : arg;
-        return await this._request("updateOneOrAdd", { collection, search: searchStr, arg: argStr, add_arg, id_gen, context });
+        return await this._request("updateOneOrAdd", [collection, search, arg, add_arg, id_gen, context]);
     }
     /**
      * Removes a database collection from the file system.
      */
     async removeCollection(name) {
-        return await this._request("removeCollection", { name });
+        return await this._request("removeCollection", [name]);
     }
 }
 exports.default = DataBaseRemote;

package/dist/cjs/client/graph.d.ts

@@ -1,4 +1,4 @@
-import { Remote, RequestData } from "./remote";
+import { Remote } from "./remote.js";
 /**
  * A class representing a graph database.
  * Uses a remote database.
@@ -13,7 +13,7 @@ declare class GraphRemote {
     /**
      * Make a request to the remote database.
      */
-    _request(type: string, data: RequestData): Promise<any>;
+    _request(type: string, params?: any[]): Promise<any>;
     /**
      * Adds an edge between two nodes.
      */

package/dist/cjs/client/graph.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 });
-const got_1 = __importDefault(require("got"));
+const ky_1 = __importDefault(require("ky"));
 /**
  * A class representing a graph database.
  * Uses a remote database.
@@ -20,74 +20,75 @@ class GraphRemote {
     /**
      * Make a request to the remote database.
      */
-    async _request(type, data) {
-        data.db = this.remote.name;
-        const res = await got_1.default.post(this.remote.url + "/db/graph/" + type, {
-            // @ts-ignore
-            body: data,
+    async _request(type, params = []) {
+        const data = {
+            db: this.remote.name,
+            params
+        };
+        const res = await ky_1.default.post(this.remote.url + "/db/" + type, {
+            json: data,
             headers: {
                 "Authorization": this.remote.auth
             },
-            json: true,
-            responseType: "json"
-        });
-        if (res.body.err)
-            throw new Error(res.body.msg);
-        return res.body.result;
+            throwHttpErrors: false
+        }).json();
+        if (res.err)
+            throw new Error(res.msg);
+        return res.result;
     }
     /**
      * Adds an edge between two nodes.
      */
     async add(collection, nodeA, nodeB) {
-        return await this._request("add", { collection, nodeA, nodeB });
+        return await this._request("add", [collection, nodeA, nodeB]);
     }
     /**
      * Removes an edge between two nodes.
      */
     async remove(collection, nodeA, nodeB) {
-        return await this._request("remove", { collection, nodeA, nodeB });
+        return await this._request("remove", [collection, nodeA, nodeB]);
     }
     /**
      * Finds all edges with either node equal to `node`.
      */
     async find(collection, node) {
-        return await this._request("find", { collection, node });
+        return await this._request("find", [collection, node]);
     }
     /**
      * Finds one edge with either node equal to `nodeA` and the other equal to `nodeB`.
      */
     async findOne(collection, nodeA, nodeB) {
-        return await this._request("findOne", { collection, nodeA, nodeB });
+        return await this._request("findOne", [collection, nodeA, nodeB]);
     }
     /**
      * Get all edges in the collection.
      */
     async getAll(collection) {
-        return await this._request("getAll", { collection });
+        return await this._request("getAll", [collection]);
     }
     /**
      * Get the names of all available databases.
      */
     async getCollections() {
-        return await this._request("getCollections", {});
+        return await this._request("getCollections", []);
     }
     /**
      * Check and create the specified collection if it doesn't exist.
      */
     async checkCollection(collection) {
-        return await this._request("checkCollection", { collection });
+        return await this._request("checkCollection", [collection]);
     }
     /**
      * Check if a collection exists.
      */
     async issetCollection(collection) {
-        return await this._request("issetCollection", { collection });
+        return await this._request("issetCollection", [collection]);
     }
     /**
      * Remove the specified collection.
      */
     removeCollection(collection) {
-        return this._request("removeCollection", { collection });
+        return this._request("removeCollection", [collection]);
     }
 }
 exports.default = GraphRemote;

package/dist/cjs/client/remote.d.ts

@@ -4,10 +4,9 @@ export interface Remote {
     auth: string;
 }
 export interface RequestData {
-    collection?: string;
     db?: string;
     keys?: string[];
-    [key: string]: any;
+    params?: Record<string, any>;
 }
 export interface findOptsRemote {
     select?: string[];

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

@@ -3,9 +3,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const action_js_1 = __importDefault(require("./action.js"));
-const executor_js_1 = __importDefault(require("./executor.js"));
-const CollectionManager_js_1 = __importDefault(require("./CollectionManager.js"));
+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,15 +14,17 @@ const CollectionManager_js_1 = __importDefault(require("./CollectionManager.js")
 class DataBase {
     dbAction;
     executor;
-    constructor(folder, options = {}) {
-        this.dbAction = new action_js_1.default(folder, options);
-        this.executor = new executor_js_1.default();
+    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();
     }
     /**
      * Create a new instance of a CollectionManager class.
      */
     c(collection) {
-        return new CollectionManager_js_1.default(this, collection);
+        return new CollectionManager_1.default(this, collection);
     }
     /**
      * Get the names of all available databases.

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>;