@wxn0brp/db-core 0.2.4 → 0.2.6-alpha.0

package/README.md

@@ -14,7 +14,11 @@ npm install @wxn0brp/db-core
 
 ## Documentation
 
-See the [documentation](docs/README.md) for more information about the API and usage.
+See [typedoc](https://wxn0brp.github.io/ValtheraDB-core/).
+
+## Contributing
+
+Contributions are welcome! Please submit pull requests or open issues on GitHub.
 
 ## License
 

package/dist/base/actions.d.ts

@@ -2,7 +2,6 @@ import Data from "../types/data.js";
 import { VQuery } from "../types/query.js";
 declare class ActionsBase {
     _inited: boolean;
-    numberId: boolean;
     init(...args: any[]): Promise<void>;
     getCollections(): Promise<string[]>;
     ensureCollection(config: VQuery): Promise<boolean>;

package/dist/base/actions.js

@@ -1,7 +1,6 @@
 import { setDataUsingUpdateOneOrAdd } from "../helpers/updateOneOrAdd.js";
 class ActionsBase {
     _inited = true;
-    numberId = false;
     async init(...args) { }
     async getCollections() {
         throw new Error("Not implemented");

package/dist/base/custom.d.ts

@@ -8,7 +8,7 @@ export declare class CustomActionsBase extends ActionsBase {
     /**
      * Add a new entry to the specified database.
      */
-    add(query: VQuery): Promise<import("../types/arg.js").Arg>;
+    add({ collection, data, id_gen }: VQuery): Promise<import("../types/arg.js").Arg>;
     /**
      * Find entries in the specified database based on search criteria.
      */

package/dist/base/custom.js

@@ -1,4 +1,4 @@
-import { addId } from "../helpers/addId.js";
+import genId from "../helpers/gen.js";
 import { findUtil } from "../utils/action.js";
 import ActionsBase from "./actions.js";
 export class CustomActionsBase extends ActionsBase {
@@ -9,10 +9,10 @@ export class CustomActionsBase extends ActionsBase {
     /**
      * Add a new entry to the specified database.
      */
-    async add(query) {
-        await this.ensureCollection(query);
-        await addId(query, this);
-        const { collection, data } = query;
+    async add({ collection, data, id_gen = true }) {
+        await this.ensureCollection(arguments[0]);
+        if (id_gen)
+            data._id = data._id || genId();
         await this.fileCpu.add(collection, data);
         return data;
     }

package/dist/customFileCpu.d.ts

@@ -11,9 +11,9 @@ declare class CustomFileCpu implements FileCpu {
     _writeFile: WriteFile;
     constructor(readFile: ReadFile, writeFile: WriteFile);
     add(file: string, data: Data): Promise<void>;
-    find(file: string, search: Search, context?: VContext, findOpts?: FindOpts): Promise<any[] | false>;
-    findOne(file: string, search: Search, context?: VContext, findOpts?: FindOpts): Promise<any | false>;
-    remove(file: string, one: boolean, search: Search, context?: VContext): Promise<boolean>;
-    update(file: string, one: boolean, search: Search, updater: Updater, context?: VContext): Promise<boolean>;
+    find(file: string, arg: Search, context?: VContext, findOpts?: FindOpts): Promise<any[] | false>;
+    findOne(file: string, arg: Search, context?: VContext, findOpts?: FindOpts): Promise<any | false>;
+    remove(file: string, one: boolean, arg: Search, context?: VContext): Promise<boolean>;
+    update(file: string, one: boolean, arg: Search, updater: Updater, context?: VContext): Promise<boolean>;
 }
 export default CustomFileCpu;

package/dist/customFileCpu.js

@@ -1,6 +1,5 @@
 import hasFieldsAdvanced from "./utils/hasFieldsAdvanced.js";
 import updateFindObject from "./utils/updateFindObject.js";
-import updateObjectAdvanced from "./utils/updateObject.js";
 export function pathRepair(path) {
     return path.replaceAll("//", "/");
 }
@@ -17,26 +16,26 @@ class CustomFileCpu {
         entries.push(data);
         await this._writeFile(file, entries);
     }
-    async find(file, search, context = {}, findOpts = {}) {
+    async find(file, arg, context = {}, findOpts = {}) {
         file = pathRepair(file);
         const entries = await this._readFile(file);
-        const results = entries.filter(entry => typeof search === "function" ? search(entry, context) : hasFieldsAdvanced(entry, search));
+        const results = entries.filter(entry => typeof arg === "function" ? arg(entry, context) : hasFieldsAdvanced(entry, arg));
         return results.length ? results.map(res => updateFindObject(res, findOpts)) : [];
     }
-    async findOne(file, search, context = {}, findOpts = {}) {
+    async findOne(file, arg, context = {}, findOpts = {}) {
         file = pathRepair(file);
         const entries = await this._readFile(file);
-        const result = entries.find(entry => typeof search === "function" ? search(entry, context) : hasFieldsAdvanced(entry, search));
+        const result = entries.find(entry => typeof arg === "function" ? arg(entry, context) : hasFieldsAdvanced(entry, arg));
         return result ? updateFindObject(result, findOpts) : false;
     }
-    async remove(file, one, search, context = {}) {
+    async remove(file, one, arg, context = {}) {
         file = pathRepair(file);
         let entries = await this._readFile(file);
         let removed = false;
         entries = entries.filter(entry => {
             if (removed && one)
                 return true;
-            let match = typeof search === "function" ? search(entry, context) : hasFieldsAdvanced(entry, search);
+            let match = typeof arg === "function" ? arg(entry, context) : hasFieldsAdvanced(entry, arg);
             if (match) {
                 removed = true;
                 return false;
@@ -48,17 +47,17 @@ class CustomFileCpu {
         await this._writeFile(file, entries);
         return true;
     }
-    async update(file, one, search, updater, context = {}) {
+    async update(file, one, arg, updater, context = {}) {
         file = pathRepair(file);
         let entries = await this._readFile(file);
         let updated = false;
         entries = entries.map(entry => {
             if (updated && one)
                 return entry;
-            let match = typeof search === "function" ? search(entry, context) : hasFieldsAdvanced(entry, search);
+            let match = typeof arg === "function" ? arg(entry, context) : hasFieldsAdvanced(entry, arg);
             if (match) {
                 updated = true;
-                return typeof updater === "function" ? updater(entry, context) : updateObjectAdvanced(entry, updater);
+                return typeof updater === "function" ? updater(entry, context) : { ...entry, ...updater };
             }
             return entry;
         });

package/dist/db/valthera.js

@@ -16,8 +16,6 @@ class ValtheraClass {
         this.dbAction = options.dbAction || new ActionsBase();
         this.executor = options.executor || new executorC();
         this.emiter = new VEE();
-        if (options.numberId)
-            this.dbAction.numberId = true;
     }
     async init(...args) {
         if (this.dbAction._inited)

package/dist/helpers/executor.d.ts

@@ -8,7 +8,7 @@ interface Task {
  * A simple executor for queuing and executing asynchronous operations sequentially.
  * @class
  */
-declare class ExecutorC {
+declare class executorC {
     quote: Task[];
     isExecuting: boolean;
     /**
@@ -25,5 +25,4 @@ declare class ExecutorC {
      */
     execute(): Promise<void>;
 }
-export default ExecutorC;
-export { ExecutorC as executorC };
+export default executorC;

package/dist/helpers/executor.js

@@ -2,7 +2,7 @@
  * A simple executor for queuing and executing asynchronous operations sequentially.
  * @class
  */
-class ExecutorC {
+class executorC {
     quote;
     isExecuting;
     /**
@@ -42,5 +42,4 @@ class ExecutorC {
         this.isExecuting = false;
     }
 }
-export default ExecutorC;
-export { ExecutorC as executorC };
+export default executorC;

package/dist/types/fileCpu.d.ts

@@ -13,39 +13,39 @@ interface FileCpu {
     /**
      * Asynchronously finds multiple entries in a file based on search criteria.
      * @param file The path to the file.
-     * @param search The search criteria.
+     * @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, search: Search, context?: VContext, findOpts?: FindOpts): Promise<any[] | false>;
+    find(file: string, arg: Search, context?: VContext, findOpts?: FindOpts): Promise<any[] | false>;
     /**
      * Asynchronously finds one entry in a file based on search criteria.
      * @param file The path to the file.
-     * @param search The search criteria.
+     * @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, search: Search, context?: VContext, findOpts?: FindOpts): Promise<any | false>;
+    findOne(file: string, arg: Search, context?: VContext, findOpts?: FindOpts): Promise<any | false>;
     /**
    * Asynchronously removes entries from a file based on search criteria.
    * @param file The path to the file.
-   * @param search The search criteria.
+   * @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(file: string, one: boolean, search: Search, context?: VContext): Promise<boolean>;
+    remove(file: string, one: boolean, arg: Search, context?: VContext): Promise<boolean>;
     /**
      * Asynchronously updates entries in a file based on search criteria and an updater function or object.
      * @param file The path to the file.
-     * @param search The search criteria.
+     * @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(file: string, one: boolean, search: Search, updater: Updater, context?: VContext): Promise<boolean>;
+    update(file: string, one: boolean, arg: Search, updater: Updater, context?: VContext): Promise<boolean>;
 }
 export default FileCpu;

package/dist/types/options.d.ts

@@ -5,7 +5,6 @@ export interface DbOpts {
     maxFileSize?: number;
     dbAction?: ActionsBase;
     executor?: executorC;
-    numberId?: boolean;
 }
 export interface DbFindOpts<T = any> {
     reverse?: boolean;

package/dist/types/query.d.ts

@@ -9,6 +9,7 @@ export interface VQuery {
     findOpts?: FindOpts;
     data?: Arg;
     id_gen?: boolean;
+    limit?: number;
     add_arg?: Arg;
     updater?: Updater;
 }

package/dist/version.js

@@ -1 +1 @@
-export const version = "0.2.4";
+export const version = "0.2.3";

package/package.json

@@ -1,38 +1,41 @@
 {
-  "name": "@wxn0brp/db-core",
-  "version": "0.2.4",
-  "types": "dist/index.d.ts",
-  "main": "dist/index.js",
-  "author": "wxn0brP",
-  "license": "MIT",
-  "type": "module",
-  "description": "ValtheraDB Core",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/wxn0brP/ValtheraDB-core.git"
-  },
-  "homepage": "https://github.com/wxn0brP/ValtheraDB",
-  "dependencies": {
-    "@wxn0brp/event-emitter": "^0.0.2"
-  },
-  "devDependencies": {
-    "@types/node": "^24.2.0",
-    "tsc-alias": "^1.8.10",
-    "typescript": "^5.9.2"
-  },
-  "files": [
-    "dist"
-  ],
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+    "name": "@wxn0brp/db-core",
+    "version": "0.2.6-alpha.0",
+    "types": "dist/index.d.ts",
+    "main": "dist/index.js",
+    "author": "wxn0brP",
+    "license": "MIT",
+    "type": "module",
+    "description": "ValtheraDB Core",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/wxn0brP/ValtheraDB-core.git"
     },
-    "./*": {
-      "types": "./dist/*.d.ts",
-      "import": "./dist/*.js",
-      "default": "./dist/*.js"
+    "homepage": "https://github.com/wxn0brP/ValtheraDB",
+    "scripts": {
+        "build": "tsc && tsc-alias"
+    },
+    "dependencies": {
+        "@wxn0brp/event-emitter": "^0.0.3"
+    },
+    "devDependencies": {
+        "@types/node": "*",
+        "tsc-alias": "*",
+        "typescript": "*"
+    },
+    "files": [
+        "dist"
+    ],
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "default": "./dist/index.js"
+        },
+        "./*": {
+            "types": "./dist/*.d.ts",
+            "import": "./dist/*.js",
+            "default": "./dist/*.js"
+        }
     }
-  }
 }

package/dist/helpers/addId.d.ts

@@ -1,3 +0,0 @@
-import ActionsBase from "../base/actions.js";
-import { VQuery } from "../types/query.js";
-export declare function addId(query: VQuery, actions: ActionsBase, defaultGen?: boolean): Promise<import("../types/arg.js").Arg>;

package/dist/helpers/addId.js

@@ -1,24 +0,0 @@
-import genId from "./gen.js";
-export async function addId(query, actions, defaultGen = true) {
-    const { collection, data } = query;
-    const id_gen = query.id_gen ?? defaultGen;
-    if (!id_gen)
-        return data;
-    if (data._id)
-        return data;
-    const { numberId } = actions;
-    if (!numberId) {
-        data._id = genId();
-        return;
-    }
-    const find = await actions.findOne({ collection: "__vdb_id", search: { c: collection } });
-    data._id = find ? find.i + 1 : 1;
-    await actions.updateOneOrAdd({
-        collection: "__vdb_id",
-        search: { c: collection },
-        updater: {
-            $inc: { i: 1 }
-        },
-        id_gen: false,
-    });
-}