@wxn0brp/vql-client 0.2.8 → 0.2.10

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 wxn0brP
+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

package/README.md

@@ -9,6 +9,12 @@ Supports:
 - Fully typed with TypeScript
 - Custom transport layers and lifecycle hooks
 
+## Installation
+
+```bash
+npm install @wxn0brp/vql-client
+```
+
 ## DOCS
 
 [API Reference](https://wxn0brp.github.io/VQL-client/)
@@ -32,9 +38,7 @@ const result = await fetchVQL("db1 user! s._id = xyz");
 </script>
 ```
 
-## Usage
-
-### `fetchVQL<T = any>(query: string | object, vars?: Object, hookContext?: Object): Promise<T>`
+### `fetchVQL<T = any>(query: string | object, vars?: Object, hookContext?: Object, fetchOptions?: FetchOptions): Promise<T>`
 
 Executes a VQL query and returns the result (unwrapped from `{ result }`, unless an error is present).
 
@@ -82,10 +86,16 @@ Returns:
 }
 ```
 
+## About Releases
+
+Some releases may not have associated source code commits (e.g., `0.2.8`, `0.2.7`). These releases contain type definition updates only.
+
+The `vql.d.ts` file is not maintained in this repository. During the release process, it is fetched (via `curl`) from the main project repository and included in the published package. If only the external type definitions change, a new version is published without modifying this repository’s source code.
+
 ## License
 
-MIT wxn0brP
+MIT. See [LICENSE](./LICENSE)
 
 ## Contributing
 
-Contributions are welcome!
+Contributions are welcome!

package/dist/vql.d.ts

@@ -1,3 +1,6 @@
+export interface Data {
+    [key: string]: any;
+}
 export type KeysMatching<T, V, C = V> = {
     [K in keyof T]-?: T[K] extends C ? K : never;
 }[keyof T];
@@ -22,10 +25,10 @@ export type ComparisonOperators<T = any> = {
         number,
         number
     ], number>;
-    $in?: DeepPartial<T> & {
+    $in?: {
         [K in keyof T]?: T[K] extends any[] ? T[K] : T[K][];
     };
-    $nin?: DeepPartial<T> & {
+    $nin?: {
         [K in keyof T]?: T[K] extends any[] ? T[K] : T[K][];
     };
     $idGt?: NestedValue<T, string | number, string | number>;
@@ -38,8 +41,12 @@ export type TypeAndExistenceOperators<T = any> = {
     $type?: NestedValue<T, JSPrimitiveType, any>;
 };
 export type ArrayOperators<T = any> = {
-    $arrinc?: DeepPartial<T>;
-    $arrincall?: DeepPartial<T>;
+    $arrinc?: {
+        [K in keyof T]?: T[K] extends any[] ? T[K][number][] : T[K][];
+    };
+    $arrincall?: {
+        [K in keyof T]?: T[K] extends any[] ? T[K][number][] : T[K][];
+    };
     $size?: NestedValue<T, number>;
 };
 export type StringOperators<T = any> = {
@@ -80,8 +87,42 @@ export type SearchFunc<T = any> = (data: T, context: VContext) => boolean;
 export type UpdaterFunc<T = any> = (data: T, context: VContext) => boolean;
 export type Search<T = any> = SearchOptions<T> | SearchFunc<T>;
 export type Updater<T = any> = UpdaterArg<T> | UpdaterArg<T>[] | UpdaterFunc<T>;
-export interface Data {
-    [key: string]: any;
+export interface UpdateOneOrAdd<T> {
+    add_arg?: Arg<T>;
+    id_gen?: boolean;
+    context?: VContext;
+}
+export interface VQuery_Control {
+}
+export interface VQuery<T = Data> {
+    collection?: string;
+    search?: Search<T>;
+    context?: VContext;
+    dbFindOpts?: DbFindOpts<T>;
+    findOpts?: FindOpts<T>;
+    data?: Arg<T>;
+    id_gen?: boolean;
+    add_arg?: Arg<T>;
+    updater?: Updater<T>;
+    control?: VQuery_Control;
+}
+declare namespace VQueryT {
+    type QueryBase<T = Data> = Required<Pick<VQuery<T>, "collection" | "search">> & Pick<VQuery<T>, "control">;
+    type Add<T = Data> = Required<Pick<VQuery<T>, "data" | "collection">> & Pick<VQuery<T>, "id_gen" | "control">;
+    type Find<T = Data> = Omit<QueryBase, "search"> & Pick<VQuery<T>, "search"> & Pick<VQuery<T>, "findOpts" | "dbFindOpts" | "context">;
+    type FindOne<T = Data> = QueryBase & Pick<VQuery<T>, "findOpts" | "context">;
+    type Update<T = Data> = QueryBase & Required<Pick<VQuery<T>, "updater">> & Pick<VQuery<T>, "context">;
+    type Remove<T = Data> = QueryBase & Pick<VQuery<T>, "context">;
+    type UpdateOneOrAdd<T = Data> = QueryBase & Update & Pick<VQuery<T>, "add_arg" | "id_gen">;
+    type ToggleOne<T = Data> = QueryBase & Pick<VQuery<T>, "data" | "context">;
+    interface UpdateOneOrAddResult<T> {
+        data: T;
+        type: "added" | "updated";
+    }
+    interface ToggleOneResult<T> {
+        data: T;
+        type: "added" | "removed";
+    }
 }
 export interface DbFindOpts<T = any> {
     reverse?: boolean;
@@ -95,40 +136,44 @@ export interface FindOpts<T = any> {
     exclude?: KeysMatching<T, any>[];
     transform?: Function;
 }
-declare class CollectionManager<D = Data> {
-    private db;
-    private collection;
+declare class Collection<D = Data> {
+    db: ValtheraCompatible;
+    collection: string;
     constructor(db: ValtheraCompatible, collection: string);
-    add(data: Arg<D>, id_gen?: boolean): Promise<D>;
+    add(data: Arg<D>, id_gen: false): Promise<D>;
+    add(data: Arg<D>, id_gen?: true): Promise<D & {
+        _id: string;
+    }>;
     find(search?: Search<D>, options?: DbFindOpts<D>, findOpts?: FindOpts<D>, context?: VContext): Promise<D[]>;
     findOne(search?: Search<D>, findOpts?: FindOpts<D>, context?: VContext): Promise<D>;
-    update(search: Search<D>, updater: Updater<D>, context?: VContext): Promise<boolean>;
-    updateOne(search: Search<D>, updater: Updater<D>, context?: VContext): Promise<boolean>;
-    remove(search: Search<D>, context?: VContext): Promise<boolean>;
-    removeOne(search: Search<D>, context?: VContext): Promise<boolean>;
-    updateOneOrAdd(search: Search<D>, updater: Updater<D>, { add_arg, context, id_gen }?: UpdateOneOrAdd<D>): Promise<boolean>;
-    toggleOne(search: Search<D>, data?: Arg<D>, context?: VContext): Promise<boolean>;
+    update(search: Search<D>, updater: Updater<D>, context?: VContext): Promise<D[]>;
+    updateOne(search: Search<D>, updater: Updater<D>, context?: VContext): Promise<D | null>;
+    remove(search: Search<D>, context?: VContext): Promise<D[]>;
+    removeOne(search: Search<D>, context?: VContext): Promise<D | null>;
+    updateOneOrAdd(search: Search<D>, updater: Updater<D>, { add_arg, context, id_gen }?: UpdateOneOrAdd<D>): Promise<VQueryT.UpdateOneOrAddResult<D>>;
+    toggleOne(search: Search<D>, data?: Arg<D>, context?: VContext): Promise<VQueryT.ToggleOneResult<D>>;
 }
 export interface ValtheraCompatible {
-    c(collection: string): CollectionManager;
+    c<T = Data>(collection: string): Collection<T>;
     getCollections(): Promise<string[]>;
     ensureCollection(collection: string): Promise<boolean>;
     issetCollection(collection: string): Promise<boolean>;
-    add<T = Data>(collection: string, data: Arg<T>, id_gen?: boolean): Promise<T>;
-    find<T = Data>(collection: string, search?: Search<T>, options?: DbFindOpts<T>, findOpts?: FindOpts<T>, context?: VContext): Promise<T[]>;
-    findOne<T = Data>(collection: string, search?: Search<T>, findOpts?: FindOpts<T>, context?: VContext): Promise<T | null>;
-    update<T = Data>(collection: string, search: Search<T>, updater: Updater<T>, context?: VContext): Promise<boolean>;
-    updateOne<T = Data>(collection: string, search: Search<T>, updater: Updater<T>, context?: VContext): Promise<boolean>;
-    remove<T = Data>(collection: string, search: Search<T>, context?: VContext): Promise<boolean>;
-    removeOne<T = Data>(collection: string, search: Search<T>, context?: VContext): Promise<boolean>;
+    add<T = Data>(query: VQueryT.Add<T>): Promise<T>;
+    find<T = Data>(query: VQueryT.Find<T>): Promise<T[]>;
+    findOne<T = Data>(query: VQueryT.FindOne<T>): Promise<T | null>;
+    update<T = Data>(query: VQueryT.Update<T>): Promise<T[]>;
+    updateOne<T = Data>(query: VQueryT.Update<T>): Promise<T | null>;
+    remove<T = Data>(query: VQueryT.Remove<T>): Promise<T[]>;
+    removeOne<T = Data>(query: VQueryT.Remove<T>): Promise<T | null>;
     removeCollection(collection: string): Promise<boolean>;
-    updateOneOrAdd<T = Data>(collection: string, search: Search<T>, updater: Updater<T>, opts?: UpdateOneOrAdd<T>): Promise<boolean>;
-    toggleOne<T = Data>(collection: string, search: Search<T>, data?: Arg<T>, context?: VContext): Promise<boolean>;
+    updateOneOrAdd<T = Data>(query: VQueryT.UpdateOneOrAdd<T>): Promise<VQueryT.UpdateOneOrAddResult<T>>;
+    toggleOne<T = Data>(query: VQueryT.ToggleOne<T>): Promise<VQueryT.ToggleOneResult<T>>;
 }
-export interface UpdateOneOrAdd<T> {
-    add_arg?: Arg<T>;
-    id_gen?: boolean;
-    context?: VContext;
+export interface VQuery_Control {
+    dir?: {
+        lastFileNum?: number;
+        sortedFiles?: string[];
+    };
 }
 declare namespace RelationTypes {
     type Path = [
@@ -148,7 +193,7 @@ declare namespace RelationTypes {
         fk?: string;
         as?: string;
         select?: string[];
-        findOpts?: DbFindOpts;
+        dbFindOpts?: DbFindOpts;
         type?: "1" | "11" | "1n" | "nm";
         relations?: Relation;
         through?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wxn0brp/vql-client",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "description": "VQL Client",
@@ -26,8 +26,8 @@
   "license": "MIT",
   "type": "module",
   "devDependencies": {
-    "esbuild": "*",
-    "typescript": "*"
+    "esbuild": "^0.28",
+    "typescript": "^6"
   },
   "files": [
     "dist"