@wxn0brp/vql-orm 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wxn0brP
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# @wxn0brp/vql-orm
+
+A lightweight and intuitive query builder for VQL (Valthera Query Language). This ORM-like library provides a fluent, chainable interface to construct VQL queries programmatically.
+
+## Installation
+
+```bash
+npm install @wxn0brp/vql-orm @wxn0brp/vql-client
+```
+
+**Note:** `@wxn0brp/vql-client` is a `peerDependency` and must be installed alongside this package.
+
+## Usage
+
+The main entry point is the `VO` (VQL ORM) factory function, which creates a new query builder instance.
+
+Here's a basic example of how to build a `find` query:
+
+```typescript
+import { VO } from "@wxn0brp/vql-orm";
+
+// Create a query builder instance for the "myShop" database
+const qb = VO("myShop");
+
+// Build a query
+const userQuery = qb
+    .from("users")
+    .select("name", "email", "age")
+    .where({
+        status: "active",
+        $gt: { age: 18 }
+    })
+    .limit(10)
+    .query(); // This generates the final VQL query object and resets the builder
+
+console.log(JSON.stringify(userQuery, null, 2));
+```
+
+This will produce the following VQL query object:
+
+```json
+{
+  "db": "myShop",
+  "d": {
+    "find": {
+      "collection": "users",
+      "search": {
+        "status": "active",
+        "$gt": {
+          "age": 18
+        }
+      },
+      "select": [
+        "name",
+        "email",
+        "age"
+      ],
+      "limit": 10
+    }
+  }
+}
+```
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import type { Search, VQLUQ } from "@wxn0brp/vql-client/vql";
+export declare class VQL_ORM {
+    dbName: string;
+    _collection: string;
+    _select: string[];
+    _search: Search;
+    _limit: number;
+    _one: boolean;
+    _vars: Record<string, any>;
+    constructor(dbName: string);
+    setDbName(dbName: string): void;
+    from(collection: string): this;
+    select(...select: string[]): this;
+    where(search: Search): this;
+    limit(limit: number): this;
+    one(on?: boolean): this;
+    var(name: string, value: any): this;
+    vars(vars: Record<string, any>): this;
+    query(): VQLUQ;
+    reset(): void;
+}
+export declare function VO(db: string): VQL_ORM;

package/dist/index.js

@@ -0,0 +1,77 @@
+import { deepMerge } from "./merge.js";
+export class VQL_ORM {
+    dbName;
+    _collection;
+    _select;
+    _search;
+    _limit;
+    _one;
+    _vars;
+    constructor(dbName) {
+        this.dbName = dbName;
+        this.reset();
+    }
+    setDbName(dbName) {
+        this.dbName = dbName;
+    }
+    from(collection) {
+        this._collection = collection;
+        return this;
+    }
+    select(...select) {
+        this._select = (this._select || []).concat(select);
+        return this;
+    }
+    where(search) {
+        this._search = deepMerge(this._search, search);
+        return this;
+    }
+    limit(limit) {
+        this._limit = limit;
+        return this;
+    }
+    one(on = true) {
+        this._one = on;
+        return this;
+    }
+    var(name, value) {
+        this._vars[name] = value;
+        return this;
+    }
+    vars(vars) {
+        this._vars = deepMerge(this._vars, vars);
+        return this;
+    }
+    query() {
+        const op = "find" + (this._one ? "One" : "");
+        const q = {
+            db: this.dbName,
+            d: {}
+        };
+        const qData = {
+            collection: this._collection,
+            search: this._search,
+        };
+        if (Object.keys(this._select).length)
+            qData.select = this._select;
+        if (this._limit)
+            qData.limit = this._limit;
+        // @ts-ignore
+        q.d[op] = qData;
+        if (Object.keys(this._vars))
+            q.var = this._vars;
+        this.reset();
+        return q;
+    }
+    reset() {
+        this._collection = "";
+        this._select = [];
+        this._search = {};
+        this._limit = 0;
+        this._one = false;
+        this._vars = {};
+    }
+}
+export function VO(db) {
+    return new VQL_ORM(db);
+}

package/dist/merge.d.ts

@@ -0,0 +1 @@
+export declare function deepMerge<T extends object>(...sources: T[]): T;

package/dist/merge.js

@@ -0,0 +1,16 @@
+const isObj = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+export function deepMerge(...sources) {
+    const out = {};
+    for (const src of sources) {
+        for (const key in src) {
+            if (!Object.prototype.hasOwnProperty.call(src, key))
+                continue;
+            const sv = src[key];
+            const ov = out[key];
+            out[key] = isObj(sv) && isObj(ov)
+                ? deepMerge(ov, sv)
+                : sv;
+        }
+    }
+    return out;
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+	"name": "@wxn0brp/vql-orm",
+	"version": "0.0.1",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"description": "",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/wxn0brP/VQL-orm.git"
+	},
+	"homepage": "https://github.com/wxn0brP/VQL-orm",
+	"author": "wxn0brP",
+	"license": "MIT",
+	"type": "module",
+	"scripts": {
+		"build": "tsc && tsc-alias"
+	},
+	"devDependencies": {
+		"@types/bun": "*",
+		"@wxn0brp/vql-client": "^0.2.10",
+		"tsc-alias": "^1",
+		"typescript": "^6"
+	},
+	"peerDependencies": {
+		"@wxn0brp/vql-client": "^0.2.10"
+	},
+	"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"
+		}
+	}
+}