@wxn0brp/db-core 0.11.1-alpha.0 → 0.11.1-alpha.1

package/README.md

@@ -1,17 +1,30 @@
 # @wxn0brp/db-core
 
-Core library for [ValtheraDB](https://github.com/wxn0brp/ValtheraDB).
+Core runtime for [ValtheraDB](https://github.com/wxn0brP/ValtheraDB). This package contains the shared database logic that the higher-level Valthera packages build on.
 
-## ⚠️ Disclaimer
+It is usually not something you install directly unless you are:
 
-It is **not recommended** to install this module separately unless you plan to create your own ValtheraDB adapter.
+- building a custom storage adapter
+- extending the lower-level database runtime
+- working on Valthera itself
 
-## Installation
+## Install
 
 ```bash
 npm install @wxn0brp/db-core
 ```
 
+## What It Provides
+
+- collection and document primitives
+- query and update operators
+- relation handling
+- shared types used by the Valthera packages
+
+## Package Note
+
+If you are building an application, you probably want `@wxn0brp/db` instead of this package. `db-core` is the internal foundation.
+
 ## Documentation
 
 See [typedoc](https://wxn0brp.github.io/ValtheraDB-core/).
@@ -22,4 +35,4 @@ Contributions are welcome! Please submit pull requests or open issues on GitHub.
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+MIT. See [LICENSE](LICENSE).

package/dist/types/fileCpu.d.ts

@@ -5,27 +5,27 @@ export interface FileCpu {
      * Asynchronously adds an entry to a file.
      * @returns A promise resolving to `void`.
      */
-    add(file: string, config: VQueryT.Add): Promise<void>;
+    add(file: string, config: VQueryT.Add, opts?: any): Promise<void>;
     /**
      * Asynchronously finds multiple entries in a file based on search criteria.
      * @returns A promise resolving to an array of found entries, or `false` if the file does not exist.
      */
-    find(file: string, config: VQueryT.Find): Promise<DataInternal[]>;
+    find(file: string, config: VQueryT.Find, opts?: any): Promise<DataInternal[]>;
     /**
      * Asynchronously finds one entry in a file based on search criteria.
      * @returns A promise resolving to the found entry or `false` if not found.
      */
-    findOne(file: string, config: VQueryT.FindOne): Promise<DataInternal | false>;
+    findOne(file: string, config: VQueryT.FindOne, opts?: any): Promise<DataInternal | false>;
     /**
    * Asynchronously removes entries from a file based on search criteria.
    * @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, config: VQueryT.Remove, one: boolean): Promise<DataInternal[]>;
+    remove(file: string, config: VQueryT.Remove, one: boolean, opts?: any): Promise<DataInternal[]>;
     /**
      * Asynchronously updates entries in a file based on search criteria and an updater function or object.
      * @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, config: VQueryT.Update, one: boolean): Promise<DataInternal[]>;
+    update(file: string, config: VQueryT.Update, one: boolean, opts?: any): Promise<DataInternal[]>;
 }

package/dist/utils/action.d.ts

@@ -1,4 +1,4 @@
 import { Data } from "../types/data.js";
 import { FileCpu } from "../types/fileCpu.js";
 import { VQueryT } from "../types/query.js";
-export declare function findUtil(query: VQueryT.Find, fileCpuOrData: FileCpu | Object[], files: string[]): Promise<Data[]>;
+export declare function findUtil(query: VQueryT.Find, fileCpuOrData: FileCpu | Object[], files: string[], fileCpuOpts?: any): Promise<Data[]>;

package/dist/utils/action.js

@@ -1,5 +1,5 @@
 import { compareSafe } from "./compare.js";
-export async function findUtil(query, fileCpuOrData, files) {
+export async function findUtil(query, fileCpuOrData, files, fileCpuOpts) {
     const { dbFindOpts = {} } = query;
     const { reverse = false, offset = 0, limit = -1, sortBy, sortAsc = true, min, max, avg, groupBy, count, } = dbFindOpts;
     const needsAllData = min || max || avg || groupBy || count || sortBy;
@@ -18,7 +18,7 @@ export async function findUtil(query, fileCpuOrData, files) {
     else {
         const filesToProcess = reverse && !sortBy ? [...files].reverse() : files;
         for (const f of filesToProcess) {
-            let entries = await fileCpuOrData.find(f, query);
+            let entries = await fileCpuOrData.find(f, query, fileCpuOpts);
             if (reverse && !sortBy)
                 entries.reverse();
             if (needsAllData) {

package/dist/version.js

@@ -1 +1 @@
-export const version = "0.11.1-alpha.0";
+export const version = "0.11.1-alpha.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wxn0brp/db-core",
-  "version": "0.11.1-alpha.0",
+  "version": "0.11.1-alpha.1",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "author": "wxn0brP",