@hf-chimera/query-builder 0.2.0 → 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hewston Fox
+
+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

@@ -1,407 +1,407 @@
-# ChimeraQueryBuilder
-
-A type-safe query builder for constructing filters and ordering rules for Chimera Store collections. `ChimeraQueryBuilder` provides a fluent API for building complex queries with support for filtering, ordering, and nested grouping.
-
-## Features
-
-- **Type-Safe**: Full TypeScript support with automatic type inference
-- **Fluent API**: Chainable methods for building queries
-- **Complex Filtering**: Support for operators, negations, and grouped conditions
-- **Ordering**: Flexible sorting with null handling options
-- **Nested Groups**: Create complex logical groupings with AND/OR/NOT
-
-## Installation
-
-```bash
-# Install both the core store and query builder
-npm install @hf-chimera/store @hf-chimera/query-builder
-
-# Or with yarn
-yarn add @hf-chimera/store @hf-chimera/query-builder
-
-# Or with pnpm
-pnpm add @hf-chimera/store @hf-chimera/query-builder
-```
-
-## Setting Up Your Store
-
-Before using `ChimeraQueryBuilder`, you need to create entity stores. Here's a complete example:
-
-```typescript
-import { createChimeraEntityStore } from "@hf-chimera/store";
-
-// Define your entity types
-type Customer = {
-  id: number;
-  name: string;
-  email: string;
-  phone: string;
-  createdAt: Date;
-};
-
-type Order = {
-  id: number;
-  customerId: number;
-  productName: string;
-  quantity: number;
-  totalAmount: number;
-  status: "pending" | "completed" | "cancelled";
-  createdAt: Date;
-};
-
-// Create entity stores
-export const customerStore = createChimeraEntityStore<"customer", Customer>({
-  name: "customer",
-  idGetter: "id",
-  async collectionFetcher(params, requestParams) {
-    const response = await fetch(`/api/customers`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ filter: params.filter, order: params.order }),
-      signal: requestParams.signal,
-    });
-    return { data: await response.json() };
-  },
-  async itemCreator(item, requestParams) {
-    const response = await fetch(`/api/customers`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(item),
-      signal: requestParams.signal,
-    });
-    return { data: await response.json() };
-  },
-  async itemUpdater(item, requestParams) {
-    const response = await fetch(`/api/customers/${item.id}`, {
-      method: "PUT",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(item),
-      signal: requestParams.signal,
-    });
-    return { data: await response.json() };
-  },
-  async itemDeleter(id, requestParams) {
-    await fetch(`/api/customers/${id}`, {
-      method: "DELETE",
-      signal: requestParams.signal,
-    });
-    return { result: { id, success: true } };
-  },
-  async itemFetcher(params, requestParams) {
-    const response = await fetch(`/api/customers/${params.id}`, {
-      signal: requestParams.signal,
-    });
-    return { data: await response.json() };
-  },
-});
-
-export const orderStore = createChimeraEntityStore<"order", Order>({
-  name: "order",
-  idGetter: "id",
-  // ... similar CRUD operations
-});
-```
-
-## Basic Usage
-
-```typescript
-import { ChimeraQueryBuilder } from "@hf-chimera/query-builder";
-import { customerStore } from "./store";
-
-// Create a query builder instance
-const query = new ChimeraQueryBuilder<typeof customerStore, Customer, any>();
-
-// Build a simple query
-query
-  .where("name", "eq", "John")
-  .where("age", "gte", 18)
-  .orderBy("createdAt", true); // true = descending
-
-// Build the query descriptor
-const descriptor = query.build();
-// Returns: { filter: {...}, order: [...] }
-
-// Use with entity store
-const customers = customerStore.getCollection(descriptor);
-```
-
-## API Reference
-
-### `orderBy(key, desc?, nulls?)`
-
-Adds an ordering rule to the query.
-
-**Parameters:**
-
-- `key`: `ChimeraPropertyGetter<Entity> | (keyof Entity & string)` - The property to order by (can be a property name string or a property getter function)
-- `desc`: `boolean` (default: `false`) - Whether to sort in descending order
-- `nulls`: `ChimeraOrderNulls` (default: `ChimeraOrderNulls.Last`) - How to handle null values (`Last` or `First`)
-
-**Returns:** `this` - Returns the builder instance for chaining
-
-**Example:**
-
-```typescript
-query
-  .orderBy("name") // Ascending
-  .orderBy("age", true) // Descending
-  .orderBy("createdAt", false, ChimeraOrderNulls.First); // Nulls first
-```
-
-### `where(value, op, test)`
-
-Adds a filter condition to the query. Multiple `where` calls are combined with AND logic by default.
-
-**Parameters:**
-
-- `value`: `ChimeraPropertyGetter<Entity> | (KeysOfType<Entity, T> & string)` - The property to filter on (property name or getter function)
-- `op`: `Op extends keyof OperatorsMap & string` - The operator to use (e.g., `'eq'`, `'gte'`, `'in'`, etc.)
-- `test`: `Parameters<OperatorsMap[Op]>[1]` - The value to compare against (type depends on the operator)
-
-**Returns:** `this` - Returns the builder instance for chaining
-
-**Example:**
-
-```typescript
-query
-  .where("status", "eq", "active")
-  .where("age", "gte", 18)
-  .where("tags", "in", ["javascript", "typescript"]);
-```
-
-### `whereNot(value, op, test)`
-
-Adds a negated filter condition (NOT condition) to the query.
-
-**Parameters:**
-
-- `value`: Same as `where()`
-- `op`: Same as `where()`
-- `test`: Same as `where()`
-
-**Returns:** `this` - Returns the builder instance for chaining
-
-**Example:**
-
-```typescript
-query.where("status", "eq", "active").whereNot("deleted", "eq", true); // NOT deleted = true
-```
-
-### `group(conjunction, builder)`
-
-Creates a grouped condition with a specified logical conjunction. Useful for creating complex logical expressions with AND, OR, or NOT groups.
-
-**Parameters:**
-
-- `conjunction`: `ChimeraConjunctionType` - The logical operator: `'and'`, `'or'`, or `'not'`
-- `builder`: `QueryBuilderCreator<Store, Entity, OperatorsMap>` - A callback function that receives a new builder instance for building the nested query
-
-**Returns:** `this` - Returns the builder instance for chaining
-
-**Example:**
-
-```typescript
-// Create an OR group: (status = 'active' OR status = 'pending')
-query.group("or", (q) => {
-  q.where("status", "eq", "active").where("status", "eq", "pending");
-});
-
-// Create a NOT group: NOT (age < 18 OR deleted = true)
-query.group("not", (q) => {
-  q.group("or", (nested) => {
-    nested.where("age", "lt", 18).where("deleted", "eq", true);
-  });
-});
-```
-
-### `build()`
-
-Builds and returns the final query descriptor object.
-
-**Returns:**
-
-```typescript
-{
-  filter: ChimeraFilterDescriptor<OperatorsMap, Entity> | null;
-  order: (ChimeraOrderDescriptor < Entity > []) | null;
-}
-```
-
-- `filter`: The filter descriptor, or `null` if no filters were added
-- `order`: An array of order descriptors, or `null` if no ordering was specified
-
-**Example:**
-
-```typescript
-const { filter, order } = query.build();
-
-// Use with store
-const collection = store.from("customer").getCollection({ filter, order });
-```
-
-## Examples
-
-_Note: The following examples use generic type parameters like `Store`, `User`, and `OperatorsMap`. See [Setting Up Your Store](#setting-up-your-store) section above for a complete store setup example._
-
-### Simple Filtering
-
-```typescript
-const query = new ChimeraQueryBuilder<Store, User, OperatorsMap>();
-
-query
-  .where("email", "eq", "user@example.com")
-  .where("active", "eq", true)
-  .orderBy("createdAt", true);
-
-const { filter, order } = query.build();
-```
-
-### Complex Logical Groups
-
-```typescript
-const query = new ChimeraQueryBuilder<Store, Post, OperatorsMap>();
-
-query
-  // Main AND condition
-  .where("published", "eq", true)
-  .where("createdAt", "gte", new Date("2024-01-01"))
-
-  // OR group: (authorId = '123' OR authorId = '456')
-  .group("or", (q) => {
-    q.where("authorId", "eq", "123").where("authorId", "eq", "456");
-  })
-
-  // NOT group: NOT (tags contains 'draft')
-  .group("not", (q) => {
-    q.where("tags", "contains", "draft");
-  })
-
-  .orderBy("createdAt", true)
-  .orderBy("title"); // Secondary sort
-
-const { filter, order } = query.build();
-```
-
-### Multiple Order Rules
-
-```typescript
-const query = new ChimeraQueryBuilder<Store, Product, OperatorsMap>();
-
-query
-  .where("inStock", "eq", true)
-  .orderBy("category") // Primary sort: category ascending
-  .orderBy("price", false) // Secondary sort: price ascending
-  .orderBy("rating", true) // Tertiary sort: rating descending
-  .orderBy("name"); // Final sort: name ascending
-
-const { filter, order } = query.build();
-```
-
-### Combining whereNot and Groups
-
-```typescript
-const query = new ChimeraQueryBuilder<Store, Article, OperatorsMap>();
-
-query
-  .where("published", "eq", true)
-  .whereNot("archived", "eq", true)
-
-  // Either in featured category OR has high views
-  .group("or", (q) => {
-    q.where("category", "eq", "featured").where("views", "gte", 1000);
-  })
-
-  // But NOT in any of these tags
-  .group("not", (q) => {
-    q.where("tags", "in", ["spam", "deprecated"]);
-  })
-
-  .orderBy("publishedAt", true);
-
-const { filter, order } = query.build();
-```
-
-### Empty Query
-
-```typescript
-const query = new ChimeraQueryBuilder<Store, Entity, OperatorsMap>();
-
-// Build without any filters or ordering
-const { filter, order } = query.build();
-// filter: null
-// order: null
-```
-
-### Chaining Pattern
-
-All methods return `this`, allowing you to chain operations:
-
-```typescript
-const query = new ChimeraQueryBuilder<Store, User, OperatorsMap>()
-  .where("active", "eq", true)
-  .where("role", "in", ["admin", "moderator"])
-  .group("or", (q) => {
-    q.where("age", "gte", 18).where("verified", "eq", true);
-  })
-  .orderBy("lastActive", true)
-  .orderBy("name");
-
-const descriptor = query.build();
-```
-
-## Type Safety
-
-The `ChimeraQueryBuilder` is fully type-safe. It ensures:
-
-- Property names must exist on the entity type
-- Operator names must exist in the `OperatorsMap`
-- Test values match the expected types for each operator
-- Property getters are correctly typed
-
-```typescript
-type User = {
-  id: string;
-  name: string;
-  age: number;
-  email: string;
-};
-
-type OperatorsMap = {
-  eq: (value: any) => boolean;
-  gte: (value: number) => boolean;
-  in: (value: any[]) => boolean;
-};
-
-const query = new ChimeraQueryBuilder<Store, User, OperatorsMap>();
-
-// ✅ Valid
-query.where("name", "eq", "John");
-query.where("age", "gte", 18);
-query.where("id", "in", ["1", "2", "3"]);
-
-// ❌ TypeScript errors
-query.where("invalidProperty", "eq", "value"); // Property doesn't exist
-query.where("age", "invalidOp", 18); // Operator doesn't exist
-query.where("age", "eq", "not a number"); // Wrong type for operator
-```
-
-## Integration
-
-### With Repository
-
-```typescript
-const query = new ChimeraQueryBuilder<typeof store, User, OperatorsMap>()
-  .where("active", "eq", true)
-  .orderBy("createdAt", true);
-
-// Use with entity store
-const users = userStore.getCollection(query.build());
-```
-
-## Notes
-
-- Multiple `where()` calls are combined with **AND** logic by default
-- Use `group('or', ...)` to create OR conditions
-- Use `group('not', ...)` or `whereNot()` for negations
-- Order rules are applied in the sequence they're added (first = primary sort)
-- An empty query builder will return `{ filter: null, order: null }`
+# ChimeraQueryBuilder
+
+A type-safe query builder for constructing filters and ordering rules for Chimera Store collections. `ChimeraQueryBuilder` provides a fluent API for building complex queries with support for filtering, ordering, and nested grouping.
+
+## Features
+
+- **Type-Safe**: Full TypeScript support with automatic type inference
+- **Fluent API**: Chainable methods for building queries
+- **Complex Filtering**: Support for operators, negations, and grouped conditions
+- **Ordering**: Flexible sorting with null handling options
+- **Nested Groups**: Create complex logical groupings with AND/OR/NOT
+
+## Installation
+
+```bash
+# Install both the core store and query builder
+npm install @hf-chimera/store @hf-chimera/query-builder
+
+# Or with yarn
+yarn add @hf-chimera/store @hf-chimera/query-builder
+
+# Or with pnpm
+pnpm add @hf-chimera/store @hf-chimera/query-builder
+```
+
+## Setting Up Your Store
+
+Before using `ChimeraQueryBuilder`, you need to create entity stores. Here's a complete example:
+
+```typescript
+import { createChimeraEntityStore } from "@hf-chimera/store";
+
+// Define your entity types
+type Customer = {
+  id: number;
+  name: string;
+  email: string;
+  phone: string;
+  createdAt: Date;
+};
+
+type Order = {
+  id: number;
+  customerId: number;
+  productName: string;
+  quantity: number;
+  totalAmount: number;
+  status: "pending" | "completed" | "cancelled";
+  createdAt: Date;
+};
+
+// Create entity stores
+export const customerStore = createChimeraEntityStore<"customer", Customer>({
+  name: "customer",
+  idGetter: "id",
+  async collectionFetcher(params, requestParams) {
+    const response = await fetch(`/api/customers`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ filter: params.filter, order: params.order }),
+      signal: requestParams.signal,
+    });
+    return { data: await response.json() };
+  },
+  async itemCreator(item, requestParams) {
+    const response = await fetch(`/api/customers`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(item),
+      signal: requestParams.signal,
+    });
+    return { data: await response.json() };
+  },
+  async itemUpdater(item, requestParams) {
+    const response = await fetch(`/api/customers/${item.id}`, {
+      method: "PUT",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(item),
+      signal: requestParams.signal,
+    });
+    return { data: await response.json() };
+  },
+  async itemDeleter(id, requestParams) {
+    await fetch(`/api/customers/${id}`, {
+      method: "DELETE",
+      signal: requestParams.signal,
+    });
+    return { result: { id, success: true } };
+  },
+  async itemFetcher(params, requestParams) {
+    const response = await fetch(`/api/customers/${params.id}`, {
+      signal: requestParams.signal,
+    });
+    return { data: await response.json() };
+  },
+});
+
+export const orderStore = createChimeraEntityStore<"order", Order>({
+  name: "order",
+  idGetter: "id",
+  // ... similar CRUD operations
+});
+```
+
+## Basic Usage
+
+```typescript
+import { ChimeraQueryBuilder } from "@hf-chimera/query-builder";
+import { customerStore } from "./store";
+
+// Create a query builder instance
+const query = new ChimeraQueryBuilder<typeof customerStore, Customer, any>();
+
+// Build a simple query
+query
+  .where("name", "eq", "John")
+  .where("age", "gte", 18)
+  .orderBy("createdAt", true); // true = descending
+
+// Build the query descriptor
+const descriptor = query.build();
+// Returns: { filter: {...}, order: [...] }
+
+// Use with entity store
+const customers = customerStore.getCollection(descriptor);
+```
+
+## API Reference
+
+### `orderBy(key, desc?, nulls?)`
+
+Adds an ordering rule to the query.
+
+**Parameters:**
+
+- `key`: `ChimeraPropertyGetter<Entity> | (keyof Entity & string)` - The property to order by (can be a property name string or a property getter function)
+- `desc`: `boolean` (default: `false`) - Whether to sort in descending order
+- `nulls`: `ChimeraOrderNulls` (default: `ChimeraOrderNulls.Last`) - How to handle null values (`Last` or `First`)
+
+**Returns:** `this` - Returns the builder instance for chaining
+
+**Example:**
+
+```typescript
+query
+  .orderBy("name") // Ascending
+  .orderBy("age", true) // Descending
+  .orderBy("createdAt", false, ChimeraOrderNulls.First); // Nulls first
+```
+
+### `where(value, op, test)`
+
+Adds a filter condition to the query. Multiple `where` calls are combined with AND logic by default.
+
+**Parameters:**
+
+- `value`: `ChimeraPropertyGetter<Entity> | (KeysOfType<Entity, T> & string)` - The property to filter on (property name or getter function)
+- `op`: `Op extends keyof OperatorsMap & string` - The operator to use (e.g., `'eq'`, `'gte'`, `'in'`, etc.)
+- `test`: `Parameters<OperatorsMap[Op]>[1]` - The value to compare against (type depends on the operator)
+
+**Returns:** `this` - Returns the builder instance for chaining
+
+**Example:**
+
+```typescript
+query
+  .where("status", "eq", "active")
+  .where("age", "gte", 18)
+  .where("tags", "in", ["javascript", "typescript"]);
+```
+
+### `whereNot(value, op, test)`
+
+Adds a negated filter condition (NOT condition) to the query.
+
+**Parameters:**
+
+- `value`: Same as `where()`
+- `op`: Same as `where()`
+- `test`: Same as `where()`
+
+**Returns:** `this` - Returns the builder instance for chaining
+
+**Example:**
+
+```typescript
+query.where("status", "eq", "active").whereNot("deleted", "eq", true); // NOT deleted = true
+```
+
+### `group(conjunction, builder)`
+
+Creates a grouped condition with a specified logical conjunction. Useful for creating complex logical expressions with AND, OR, or NOT groups.
+
+**Parameters:**
+
+- `conjunction`: `ChimeraConjunctionType` - The logical operator: `'and'`, `'or'`, or `'not'`
+- `builder`: `QueryBuilderCreator<Store, Entity, OperatorsMap>` - A callback function that receives a new builder instance for building the nested query
+
+**Returns:** `this` - Returns the builder instance for chaining
+
+**Example:**
+
+```typescript
+// Create an OR group: (status = 'active' OR status = 'pending')
+query.group("or", (q) => {
+  q.where("status", "eq", "active").where("status", "eq", "pending");
+});
+
+// Create a NOT group: NOT (age < 18 OR deleted = true)
+query.group("not", (q) => {
+  q.group("or", (nested) => {
+    nested.where("age", "lt", 18).where("deleted", "eq", true);
+  });
+});
+```
+
+### `build()`
+
+Builds and returns the final query descriptor object.
+
+**Returns:**
+
+```typescript
+{
+  filter: ChimeraFilterDescriptor<OperatorsMap, Entity> | null;
+  order: (ChimeraOrderDescriptor < Entity > []) | null;
+}
+```
+
+- `filter`: The filter descriptor, or `null` if no filters were added
+- `order`: An array of order descriptors, or `null` if no ordering was specified
+
+**Example:**
+
+```typescript
+const { filter, order } = query.build();
+
+// Use with store
+const collection = store.from("customer").getCollection({ filter, order });
+```
+
+## Examples
+
+_Note: The following examples use generic type parameters like `Store`, `User`, and `OperatorsMap`. See [Setting Up Your Store](#setting-up-your-store) section above for a complete store setup example._
+
+### Simple Filtering
+
+```typescript
+const query = new ChimeraQueryBuilder<Store, User, OperatorsMap>();
+
+query
+  .where("email", "eq", "user@example.com")
+  .where("active", "eq", true)
+  .orderBy("createdAt", true);
+
+const { filter, order } = query.build();
+```
+
+### Complex Logical Groups
+
+```typescript
+const query = new ChimeraQueryBuilder<Store, Post, OperatorsMap>();
+
+query
+  // Main AND condition
+  .where("published", "eq", true)
+  .where("createdAt", "gte", new Date("2024-01-01"))
+
+  // OR group: (authorId = '123' OR authorId = '456')
+  .group("or", (q) => {
+    q.where("authorId", "eq", "123").where("authorId", "eq", "456");
+  })
+
+  // NOT group: NOT (tags contains 'draft')
+  .group("not", (q) => {
+    q.where("tags", "contains", "draft");
+  })
+
+  .orderBy("createdAt", true)
+  .orderBy("title"); // Secondary sort
+
+const { filter, order } = query.build();
+```
+
+### Multiple Order Rules
+
+```typescript
+const query = new ChimeraQueryBuilder<Store, Product, OperatorsMap>();
+
+query
+  .where("inStock", "eq", true)
+  .orderBy("category") // Primary sort: category ascending
+  .orderBy("price", false) // Secondary sort: price ascending
+  .orderBy("rating", true) // Tertiary sort: rating descending
+  .orderBy("name"); // Final sort: name ascending
+
+const { filter, order } = query.build();
+```
+
+### Combining whereNot and Groups
+
+```typescript
+const query = new ChimeraQueryBuilder<Store, Article, OperatorsMap>();
+
+query
+  .where("published", "eq", true)
+  .whereNot("archived", "eq", true)
+
+  // Either in featured category OR has high views
+  .group("or", (q) => {
+    q.where("category", "eq", "featured").where("views", "gte", 1000);
+  })
+
+  // But NOT in any of these tags
+  .group("not", (q) => {
+    q.where("tags", "in", ["spam", "deprecated"]);
+  })
+
+  .orderBy("publishedAt", true);
+
+const { filter, order } = query.build();
+```
+
+### Empty Query
+
+```typescript
+const query = new ChimeraQueryBuilder<Store, Entity, OperatorsMap>();
+
+// Build without any filters or ordering
+const { filter, order } = query.build();
+// filter: null
+// order: null
+```
+
+### Chaining Pattern
+
+All methods return `this`, allowing you to chain operations:
+
+```typescript
+const query = new ChimeraQueryBuilder<Store, User, OperatorsMap>()
+  .where("active", "eq", true)
+  .where("role", "in", ["admin", "moderator"])
+  .group("or", (q) => {
+    q.where("age", "gte", 18).where("verified", "eq", true);
+  })
+  .orderBy("lastActive", true)
+  .orderBy("name");
+
+const descriptor = query.build();
+```
+
+## Type Safety
+
+The `ChimeraQueryBuilder` is fully type-safe. It ensures:
+
+- Property names must exist on the entity type
+- Operator names must exist in the `OperatorsMap`
+- Test values match the expected types for each operator
+- Property getters are correctly typed
+
+```typescript
+type User = {
+  id: string;
+  name: string;
+  age: number;
+  email: string;
+};
+
+type OperatorsMap = {
+  eq: (value: any) => boolean;
+  gte: (value: number) => boolean;
+  in: (value: any[]) => boolean;
+};
+
+const query = new ChimeraQueryBuilder<Store, User, OperatorsMap>();
+
+// ✅ Valid
+query.where("name", "eq", "John");
+query.where("age", "gte", 18);
+query.where("id", "in", ["1", "2", "3"]);
+
+// ❌ TypeScript errors
+query.where("invalidProperty", "eq", "value"); // Property doesn't exist
+query.where("age", "invalidOp", 18); // Operator doesn't exist
+query.where("age", "eq", "not a number"); // Wrong type for operator
+```
+
+## Integration
+
+### With Repository
+
+```typescript
+const query = new ChimeraQueryBuilder<typeof store, User, OperatorsMap>()
+  .where("active", "eq", true)
+  .orderBy("createdAt", true);
+
+// Use with entity store
+const users = userStore.getCollection(query.build());
+```
+
+## Notes
+
+- Multiple `where()` calls are combined with **AND** logic by default
+- Use `group('or', ...)` to create OR conditions
+- Use `group('not', ...)` or `whereNot()` for negations
+- Order rules are applied in the sequence they're added (first = primary sort)
+- An empty query builder will return `{ filter: null, order: null }`

package/dist/index.cjs

@@ -44,6 +44,13 @@ var DefaultChimeraQueryBuilder = class {
 	}
 };
 
+//#endregion
+//#region factory.ts
+function createDefaultQueryBuilder() {
+	return new DefaultChimeraQueryBuilder();
+}
+
 //#endregion
 exports.DefaultChimeraQueryBuilder = DefaultChimeraQueryBuilder;
+exports.createDefaultQueryBuilder = createDefaultQueryBuilder;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["ChimeraOrderNulls"],"sources":["../DefaultChimeraQueryBuilder.ts"],"sourcesContent":["import {\n\ttype AnyChimeraEntityStore,\n\ttype ChimeraConjunctionDescriptor,\n\ttype ChimeraConjunctionOperationDescriptor,\n\ttype ChimeraConjunctionType,\n\ttype ChimeraEntityStoreEntity,\n\ttype ChimeraEntityStoreOperatorsMap,\n\ttype ChimeraFilterDescriptor,\n\ttype ChimeraOrderDescriptor,\n\tChimeraOrderNulls,\n\ttype ChimeraPropertyGetter,\n\ttype Constructable,\n\tchimeraCreateConjunction,\n\tchimeraCreateNot,\n\tchimeraCreateOperator,\n\tchimeraCreateOrderBy,\n\ttype KeysOfType,\n} from \"@hf-chimera/store\";\nimport type { ChimeraQueryBuilder, QueryBuilderCreator } from \"./types\";\n\nexport class DefaultChimeraQueryBuilder<\n\tTStore extends AnyChimeraEntityStore,\n\tTEntity extends ChimeraEntityStoreEntity<TStore> = ChimeraEntityStoreEntity<TStore>,\n\tTOperatorsMap extends ChimeraEntityStoreOperatorsMap<TStore> = ChimeraEntityStoreOperatorsMap<TStore>,\n> implements ChimeraQueryBuilder<TStore>\n{\n\tprivate orderRules: ChimeraOrderDescriptor<TEntity>[] = [];\n\n\tisChimeraQueryBuilder: true = true;\n\n\tcreate(): this {\n\t\treturn new (this.constructor as Constructable)();\n\t}\n\n\torderBy(\n\t\tkey: ChimeraPropertyGetter<TEntity> | (keyof TEntity & string),\n\t\tdesc = false,\n\t\tnulls: ChimeraOrderNulls = ChimeraOrderNulls.Last,\n\t): this {\n\t\tthis.orderRules.push(chimeraCreateOrderBy<TEntity>(key, desc, nulls));\n\t\treturn this;\n\t}\n\n\tprivate filters: ChimeraConjunctionOperationDescriptor<TOperatorsMap, TEntity>[] = [];\n\tprivate rootConjunction: Exclude<ChimeraConjunctionType, \"not\"> = \"and\";\n\n\tprivate conjunction(type: Exclude<ChimeraConjunctionType, \"not\">) {\n\t\tthis.rootConjunction = type;\n\t}\n\n\tprivate buildFilter(): ChimeraConjunctionDescriptor<TOperatorsMap, TEntity> | null {\n\t\treturn this.filters.length\n\t\t\t? chimeraCreateConjunction<TEntity, TOperatorsMap>(this.rootConjunction, this.filters)\n\t\t\t: null;\n\t}\n\n\twhere<Op extends keyof TOperatorsMap & string>(\n\t\tvalue:\n\t\t\t| ChimeraPropertyGetter<TEntity, Parameters<TOperatorsMap[Op]>[0]>\n\t\t\t| (KeysOfType<TEntity, Parameters<TOperatorsMap[Op]>[0]> & string),\n\t\top: Op,\n\t\ttest: Parameters<TOperatorsMap[Op]>[1],\n\t): this {\n\t\tthis.filters.push(chimeraCreateOperator<TEntity, TOperatorsMap, Op>(op, value, test));\n\t\treturn this;\n\t}\n\n\tgroup(conjunction: ChimeraConjunctionType, builder: QueryBuilderCreator<TStore, this>): this {\n\t\tconst isNot = conjunction === \"not\";\n\t\tconst nestedBuilder = this.create();\n\n\t\t!isNot && nestedBuilder.conjunction(conjunction);\n\n\t\tbuilder(nestedBuilder);\n\n\t\tconst nestedQuery = nestedBuilder.buildFilter();\n\t\tnestedQuery && this.filters.push(isNot ? chimeraCreateNot<TEntity, TOperatorsMap>(nestedQuery) : nestedQuery);\n\n\t\treturn this;\n\t}\n\n\twhereNot<Op extends keyof TOperatorsMap & string>(\n\t\tvalue:\n\t\t\t| ChimeraPropertyGetter<TEntity, Parameters<TOperatorsMap[Op]>[0]>\n\t\t\t| (KeysOfType<TEntity, Parameters<TOperatorsMap[Op]>[0]> & string),\n\t\top: Op,\n\t\ttest: Parameters<TOperatorsMap[Op]>[1],\n\t): this {\n\t\tthis.filters.push(\n\t\t\tchimeraCreateNot<TEntity, TOperatorsMap>(chimeraCreateOperator<TEntity, TOperatorsMap, Op>(op, value, test)),\n\t\t);\n\t\treturn this;\n\t}\n\n\tbuild(): {\n\t\tfilter: ChimeraFilterDescriptor<TOperatorsMap, TEntity> | null;\n\t\torder: ChimeraOrderDescriptor<TEntity>[] | null;\n\t} {\n\t\treturn {\n\t\t\tfilter: this.buildFilter(),\n\t\t\torder: this.orderRules.length ? this.orderRules : null,\n\t\t};\n\t}\n}\n"],"mappings":";;;AAoBA,IAAa,6BAAb,MAKA;CACC,AAAQ,aAAgD,EAAE;CAE1D,wBAA8B;CAE9B,SAAe;AACd,SAAO,IAAK,KAAK,aAA+B;;CAGjD,QACC,KACA,OAAO,OACP,QAA2BA,oCAAkB,MACtC;AACP,OAAK,WAAW,iDAAmC,KAAK,MAAM,MAAM,CAAC;AACrE,SAAO;;CAGR,AAAQ,UAA2E,EAAE;CACrF,AAAQ,kBAA0D;CAElE,AAAQ,YAAY,MAA8C;AACjE,OAAK,kBAAkB;;CAGxB,AAAQ,cAA2E;AAClF,SAAO,KAAK,QAAQ,yDACgC,KAAK,iBAAiB,KAAK,QAAQ,GACpF;;CAGJ,MACC,OAGA,IACA,MACO;AACP,OAAK,QAAQ,kDAAuD,IAAI,OAAO,KAAK,CAAC;AACrF,SAAO;;CAGR,MAAM,aAAqC,SAAkD;EAC5F,MAAM,QAAQ,gBAAgB;EAC9B,MAAM,gBAAgB,KAAK,QAAQ;AAEnC,GAAC,SAAS,cAAc,YAAY,YAAY;AAEhD,UAAQ,cAAc;EAEtB,MAAM,cAAc,cAAc,aAAa;AAC/C,iBAAe,KAAK,QAAQ,KAAK,gDAAiD,YAAY,GAAG,YAAY;AAE7G,SAAO;;CAGR,SACC,OAGA,IACA,MACO;AACP,OAAK,QAAQ,0FAC+E,IAAI,OAAO,KAAK,CAAC,CAC5G;AACD,SAAO;;CAGR,QAGE;AACD,SAAO;GACN,QAAQ,KAAK,aAAa;GAC1B,OAAO,KAAK,WAAW,SAAS,KAAK,aAAa;GAClD"}
+{"version":3,"file":"index.cjs","names":["ChimeraOrderNulls"],"sources":["../DefaultChimeraQueryBuilder.ts","../factory.ts"],"sourcesContent":["import {\n\ttype AnyChimeraEntityStore,\n\ttype ChimeraConjunctionDescriptor,\n\ttype ChimeraConjunctionOperationDescriptor,\n\ttype ChimeraConjunctionType,\n\ttype ChimeraEntityStoreEntity,\n\ttype ChimeraEntityStoreOperatorsMap,\n\ttype ChimeraFilterDescriptor,\n\ttype ChimeraOrderDescriptor,\n\tChimeraOrderNulls,\n\ttype ChimeraPropertyGetter,\n\ttype Constructable,\n\tchimeraCreateConjunction,\n\tchimeraCreateNot,\n\tchimeraCreateOperator,\n\tchimeraCreateOrderBy,\n\ttype KeysOfType,\n} from \"@hf-chimera/store\";\nimport type { ChimeraQueryBuilder, QueryBuilderCreator } from \"./types\";\n\nexport class DefaultChimeraQueryBuilder<\n\tTStore extends AnyChimeraEntityStore,\n\tTEntity extends ChimeraEntityStoreEntity<TStore> = ChimeraEntityStoreEntity<TStore>,\n\tTOperatorsMap extends ChimeraEntityStoreOperatorsMap<TStore> = ChimeraEntityStoreOperatorsMap<TStore>,\n> implements ChimeraQueryBuilder<TStore>\n{\n\tprivate orderRules: ChimeraOrderDescriptor<TEntity>[] = [];\n\n\tisChimeraQueryBuilder: true = true;\n\n\tcreate(): this {\n\t\treturn new (this.constructor as Constructable)();\n\t}\n\n\torderBy(\n\t\tkey: ChimeraPropertyGetter<TEntity> | (keyof TEntity & string),\n\t\tdesc = false,\n\t\tnulls: ChimeraOrderNulls = ChimeraOrderNulls.Last,\n\t): this {\n\t\tthis.orderRules.push(chimeraCreateOrderBy<TEntity>(key, desc, nulls));\n\t\treturn this;\n\t}\n\n\tprivate filters: ChimeraConjunctionOperationDescriptor<TOperatorsMap, TEntity>[] = [];\n\tprivate rootConjunction: Exclude<ChimeraConjunctionType, \"not\"> = \"and\";\n\n\tprivate conjunction(type: Exclude<ChimeraConjunctionType, \"not\">) {\n\t\tthis.rootConjunction = type;\n\t}\n\n\tprivate buildFilter(): ChimeraConjunctionDescriptor<TOperatorsMap, TEntity> | null {\n\t\treturn this.filters.length\n\t\t\t? chimeraCreateConjunction<TEntity, TOperatorsMap>(this.rootConjunction, this.filters)\n\t\t\t: null;\n\t}\n\n\twhere<Op extends keyof TOperatorsMap & string>(\n\t\tvalue:\n\t\t\t| ChimeraPropertyGetter<TEntity, Parameters<TOperatorsMap[Op]>[0]>\n\t\t\t| (KeysOfType<TEntity, Parameters<TOperatorsMap[Op]>[0]> & string),\n\t\top: Op,\n\t\ttest: Parameters<TOperatorsMap[Op]>[1],\n\t): this {\n\t\tthis.filters.push(chimeraCreateOperator<TEntity, TOperatorsMap, Op>(op, value, test));\n\t\treturn this;\n\t}\n\n\tgroup(conjunction: ChimeraConjunctionType, builder: QueryBuilderCreator<TStore, this>): this {\n\t\tconst isNot = conjunction === \"not\";\n\t\tconst nestedBuilder = this.create();\n\n\t\t!isNot && nestedBuilder.conjunction(conjunction);\n\n\t\tbuilder(nestedBuilder);\n\n\t\tconst nestedQuery = nestedBuilder.buildFilter();\n\t\tnestedQuery && this.filters.push(isNot ? chimeraCreateNot<TEntity, TOperatorsMap>(nestedQuery) : nestedQuery);\n\n\t\treturn this;\n\t}\n\n\twhereNot<Op extends keyof TOperatorsMap & string>(\n\t\tvalue:\n\t\t\t| ChimeraPropertyGetter<TEntity, Parameters<TOperatorsMap[Op]>[0]>\n\t\t\t| (KeysOfType<TEntity, Parameters<TOperatorsMap[Op]>[0]> & string),\n\t\top: Op,\n\t\ttest: Parameters<TOperatorsMap[Op]>[1],\n\t): this {\n\t\tthis.filters.push(\n\t\t\tchimeraCreateNot<TEntity, TOperatorsMap>(chimeraCreateOperator<TEntity, TOperatorsMap, Op>(op, value, test)),\n\t\t);\n\t\treturn this;\n\t}\n\n\tbuild(): {\n\t\tfilter: ChimeraFilterDescriptor<TOperatorsMap, TEntity> | null;\n\t\torder: ChimeraOrderDescriptor<TEntity>[] | null;\n\t} {\n\t\treturn {\n\t\t\tfilter: this.buildFilter(),\n\t\t\torder: this.orderRules.length ? this.orderRules : null,\n\t\t};\n\t}\n}\n","import type { AnyChimeraEntityStore } from \"@hf-chimera/store\";\nimport { DefaultChimeraQueryBuilder } from \"./DefaultChimeraQueryBuilder\";\n\nexport function createDefaultQueryBuilder<TStore extends AnyChimeraEntityStore>(): DefaultChimeraQueryBuilder<TStore> {\n\treturn new DefaultChimeraQueryBuilder<TStore>();\n}\n"],"mappings":";;;AAoBA,IAAa,6BAAb,MAKA;CACC,AAAQ,aAAgD,EAAE;CAE1D,wBAA8B;CAE9B,SAAe;AACd,SAAO,IAAK,KAAK,aAA+B;;CAGjD,QACC,KACA,OAAO,OACP,QAA2BA,oCAAkB,MACtC;AACP,OAAK,WAAW,iDAAmC,KAAK,MAAM,MAAM,CAAC;AACrE,SAAO;;CAGR,AAAQ,UAA2E,EAAE;CACrF,AAAQ,kBAA0D;CAElE,AAAQ,YAAY,MAA8C;AACjE,OAAK,kBAAkB;;CAGxB,AAAQ,cAA2E;AAClF,SAAO,KAAK,QAAQ,yDACgC,KAAK,iBAAiB,KAAK,QAAQ,GACpF;;CAGJ,MACC,OAGA,IACA,MACO;AACP,OAAK,QAAQ,kDAAuD,IAAI,OAAO,KAAK,CAAC;AACrF,SAAO;;CAGR,MAAM,aAAqC,SAAkD;EAC5F,MAAM,QAAQ,gBAAgB;EAC9B,MAAM,gBAAgB,KAAK,QAAQ;AAEnC,GAAC,SAAS,cAAc,YAAY,YAAY;AAEhD,UAAQ,cAAc;EAEtB,MAAM,cAAc,cAAc,aAAa;AAC/C,iBAAe,KAAK,QAAQ,KAAK,gDAAiD,YAAY,GAAG,YAAY;AAE7G,SAAO;;CAGR,SACC,OAGA,IACA,MACO;AACP,OAAK,QAAQ,0FAC+E,IAAI,OAAO,KAAK,CAAC,CAC5G;AACD,SAAO;;CAGR,QAGE;AACD,SAAO;GACN,QAAQ,KAAK,aAAa;GAC1B,OAAO,KAAK,WAAW,SAAS,KAAK,aAAa;GAClD;;;;;;AClGH,SAAgB,4BAAsG;AACrH,QAAO,IAAI,4BAAoC"}

package/dist/index.d.cts

@@ -30,5 +30,8 @@ declare class DefaultChimeraQueryBuilder<TStore extends AnyChimeraEntityStore, T
   };
 }
 //#endregion
-export { type ChimeraQueryBuilder, DefaultChimeraQueryBuilder, type QueryBuilderCreator };
+//#region factory.d.ts
+declare function createDefaultQueryBuilder<TStore extends AnyChimeraEntityStore>(): DefaultChimeraQueryBuilder<TStore>;
+//#endregion
+export { type ChimeraQueryBuilder, DefaultChimeraQueryBuilder, type QueryBuilderCreator, createDefaultQueryBuilder };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../types.ts","../DefaultChimeraQueryBuilder.ts"],"sourcesContent":[],"mappings":";;;UASiB,mCAAmC;;EAAnC,MAAA,EAAA,EAAA,IAAA;EAAmC,KAAA,EAAA,EAAA;IAMa,MAAA,EAAvD,uBAAuD,CAA/B,8BAA+B,CAAA,MAAA,CAAA,EAAS,wBAAT,CAAkC,MAAlC,CAAA,CAAA,GAAA,IAAA;IAA/B,KAAA,EACzB,sBADyB,CACF,wBADE,CACuB,MADvB,CAAA,CAAA,EAAA,GAAA,IAAA;EAAiE,CAAA;;AAAzF,KAKE,mBALF,CAAA,eAMM,qBANN,EAAA,sBAOa,mBAPb,CAOiC,MAPjC,CAAA,GAO2C,mBAP3C,CAO+D,MAP/D,CAAA,CAAA,GAAA,CAAA,CAAA,EAQF,aARE,EAAA,GAQgB,OARhB,CAQwB,mBARxB,CAQ4C,MAR5C,CAAA,CAAA;;;cCKG,0CACG,uCACC,yBAAyB,UAAU,yBAAyB,+BACtD,+BAA+B,UAAU,+BAA+B,oBAClF,oBAAoB;EDfhB,QAAA,UAAA;EAAmC,qBAAA,EAAA,IAAA;EAMa,MAAA,CAAA,CAAA,EAAA,IAAA;EAA/B,OAAA,CAAA,GAAA,ECoB3B,qBDpB2B,CCoBL,ODpBK,CAAA,GAAA,CAAA,MCoBa,ODpBb,GAAA,MAAA,CAAA,EAAA,IAAA,CAAA,EAAA,OAAA,EAAA,KAAA,CAAA,ECsBzB,iBDtByB,CAAA,EAAA,IAAA;EAAiE,QAAA,OAAA;EAAzB,QAAA,eAAA;EAAhE,QAAA,WAAA;EAC+C,QAAA,WAAA;EAAzB,KAAA,CAAA,WAAA,MCwCR,aDxCQ,GAAA,MAAA,CAAA,CAAA,KAAA,EC0C3B,qBD1C2B,CC0CL,OD1CK,EC0CI,UD1CJ,CC0Ce,aD1Cf,CC0C6B,ED1C7B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CC2C1B,UD3C0B,CC2Cf,OD3Ce,EC2CN,UD3CM,CC2CK,aD3CL,CC2CmB,ED3CnB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,MAAA,CAAA,EAAA,EAAA,EC4C1B,ED5C0B,EAAA,IAAA,EC6CxB,UD7CwB,CC6Cb,aD7Ca,CC6CC,ED7CD,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,IAAA;EAAvB,KAAA,CAAA,WAAA,ECmDW,sBDnDX,EAAA,OAAA,ECmD4C,mBDnD5C,CCmDgE,MDnDhE,EAAA,IAAA,CAAA,CAAA,EAAA,IAAA;EAAsB,QAAA,CAAA,WAAA,MCiEJ,aDjEI,GAAA,MAAA,CAAA,CAAA,KAAA,ECmE1B,qBDnE0B,CCmEJ,ODnEI,ECmEK,UDnEL,CCmEgB,aDnEhB,CCmE8B,EDnE9B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CCoEzB,UDpEyB,CCoEd,ODpEc,ECoEL,UDpEK,CCoEM,aDpEN,CCoEoB,EDpEpB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,MAAA,CAAA,EAAA,EAAA,ECqEzB,EDrEyB,EAAA,IAAA,ECsEvB,UDtEuB,CCsEZ,aDtEY,CCsEE,EDtEF,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,IAAA;EAInB,KAAA,CAAA,CAAA,EAAA;IACI,MAAA,EC0EN,uBD1EM,CC0EkB,aD1ElB,EC0EiC,OD1EjC,CAAA,GAAA,IAAA;IAC2B,KAAA,EC0ElC,sBD1EkC,CC0EX,OD1EW,CAAA,EAAA,GAAA,IAAA;EAApB,CAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../types.ts","../DefaultChimeraQueryBuilder.ts","../factory.ts"],"sourcesContent":[],"mappings":";;;UASiB,mCAAmC;;EAAnC,MAAA,EAAA,EAAA,IAAA;EAAmC,KAAA,EAAA,EAAA;IAMa,MAAA,EAAvD,uBAAuD,CAA/B,8BAA+B,CAAA,MAAA,CAAA,EAAS,wBAAT,CAAkC,MAAlC,CAAA,CAAA,GAAA,IAAA;IAA/B,KAAA,EACzB,sBADyB,CACF,wBADE,CACuB,MADvB,CAAA,CAAA,EAAA,GAAA,IAAA;EAAiE,CAAA;;AAAzF,KAKE,mBALF,CAAA,eAMM,qBANN,EAAA,sBAOa,mBAPb,CAOiC,MAPjC,CAAA,GAO2C,mBAP3C,CAO+D,MAP/D,CAAA,CAAA,GAAA,CAAA,CAAA,EAQF,aARE,EAAA,GAQgB,OARhB,CAQwB,mBARxB,CAQ4C,MAR5C,CAAA,CAAA;;;cCKG,0CACG,uCACC,yBAAyB,UAAU,yBAAyB,+BACtD,+BAA+B,UAAU,+BAA+B,oBAClF,oBAAoB;EDfhB,QAAA,UAAA;EAAmC,qBAAA,EAAA,IAAA;EAMa,MAAA,CAAA,CAAA,EAAA,IAAA;EAA/B,OAAA,CAAA,GAAA,ECoB3B,qBDpB2B,CCoBL,ODpBK,CAAA,GAAA,CAAA,MCoBa,ODpBb,GAAA,MAAA,CAAA,EAAA,IAAA,CAAA,EAAA,OAAA,EAAA,KAAA,CAAA,ECsBzB,iBDtByB,CAAA,EAAA,IAAA;EAAiE,QAAA,OAAA;EAAzB,QAAA,eAAA;EAAhE,QAAA,WAAA;EAC+C,QAAA,WAAA;EAAzB,KAAA,CAAA,WAAA,MCwCR,aDxCQ,GAAA,MAAA,CAAA,CAAA,KAAA,EC0C3B,qBD1C2B,CC0CL,OD1CK,EC0CI,UD1CJ,CC0Ce,aD1Cf,CC0C6B,ED1C7B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CC2C1B,UD3C0B,CC2Cf,OD3Ce,EC2CN,UD3CM,CC2CK,aD3CL,CC2CmB,ED3CnB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,MAAA,CAAA,EAAA,EAAA,EC4C1B,ED5C0B,EAAA,IAAA,EC6CxB,UD7CwB,CC6Cb,aD7Ca,CC6CC,ED7CD,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,IAAA;EAAvB,KAAA,CAAA,WAAA,ECmDW,sBDnDX,EAAA,OAAA,ECmD4C,mBDnD5C,CCmDgE,MDnDhE,EAAA,IAAA,CAAA,CAAA,EAAA,IAAA;EAAsB,QAAA,CAAA,WAAA,MCiEJ,aDjEI,GAAA,MAAA,CAAA,CAAA,KAAA,ECmE1B,qBDnE0B,CCmEJ,ODnEI,ECmEK,UDnEL,CCmEgB,aDnEhB,CCmE8B,EDnE9B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CCoEzB,UDpEyB,CCoEd,ODpEc,ECoEL,UDpEK,CCoEM,aDpEN,CCoEoB,EDpEpB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,MAAA,CAAA,EAAA,EAAA,ECqEzB,EDrEyB,EAAA,IAAA,ECsEvB,UDtEuB,CCsEZ,aDtEY,CCsEE,EDtEF,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,IAAA;EAInB,KAAA,CAAA,CAAA,EAAA;IACI,MAAA,EC0EN,uBD1EM,CC0EkB,aD1ElB,EC0EiC,OD1EjC,CAAA,GAAA,IAAA;IAC2B,KAAA,EC0ElC,sBD1EkC,CC0EX,OD1EW,CAAA,EAAA,GAAA,IAAA;EAApB,CAAA;;;;iBEnBP,yCAAyC,0BAA0B,2BAA2B"}

package/dist/index.d.mts

@@ -30,5 +30,8 @@ declare class DefaultChimeraQueryBuilder<TStore extends AnyChimeraEntityStore, T
   };
 }
 //#endregion
-export { type ChimeraQueryBuilder, DefaultChimeraQueryBuilder, type QueryBuilderCreator };
+//#region factory.d.ts
+declare function createDefaultQueryBuilder<TStore extends AnyChimeraEntityStore>(): DefaultChimeraQueryBuilder<TStore>;
+//#endregion
+export { type ChimeraQueryBuilder, DefaultChimeraQueryBuilder, type QueryBuilderCreator, createDefaultQueryBuilder };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../types.ts","../DefaultChimeraQueryBuilder.ts"],"sourcesContent":[],"mappings":";;;UASiB,mCAAmC;;EAAnC,MAAA,EAAA,EAAA,IAAA;EAAmC,KAAA,EAAA,EAAA;IAMa,MAAA,EAAvD,uBAAuD,CAA/B,8BAA+B,CAAA,MAAA,CAAA,EAAS,wBAAT,CAAkC,MAAlC,CAAA,CAAA,GAAA,IAAA;IAA/B,KAAA,EACzB,sBADyB,CACF,wBADE,CACuB,MADvB,CAAA,CAAA,EAAA,GAAA,IAAA;EAAiE,CAAA;;AAAzF,KAKE,mBALF,CAAA,eAMM,qBANN,EAAA,sBAOa,mBAPb,CAOiC,MAPjC,CAAA,GAO2C,mBAP3C,CAO+D,MAP/D,CAAA,CAAA,GAAA,CAAA,CAAA,EAQF,aARE,EAAA,GAQgB,OARhB,CAQwB,mBARxB,CAQ4C,MAR5C,CAAA,CAAA;;;cCKG,0CACG,uCACC,yBAAyB,UAAU,yBAAyB,+BACtD,+BAA+B,UAAU,+BAA+B,oBAClF,oBAAoB;EDfhB,QAAA,UAAA;EAAmC,qBAAA,EAAA,IAAA;EAMa,MAAA,CAAA,CAAA,EAAA,IAAA;EAA/B,OAAA,CAAA,GAAA,ECoB3B,qBDpB2B,CCoBL,ODpBK,CAAA,GAAA,CAAA,MCoBa,ODpBb,GAAA,MAAA,CAAA,EAAA,IAAA,CAAA,EAAA,OAAA,EAAA,KAAA,CAAA,ECsBzB,iBDtByB,CAAA,EAAA,IAAA;EAAiE,QAAA,OAAA;EAAzB,QAAA,eAAA;EAAhE,QAAA,WAAA;EAC+C,QAAA,WAAA;EAAzB,KAAA,CAAA,WAAA,MCwCR,aDxCQ,GAAA,MAAA,CAAA,CAAA,KAAA,EC0C3B,qBD1C2B,CC0CL,OD1CK,EC0CI,UD1CJ,CC0Ce,aD1Cf,CC0C6B,ED1C7B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CC2C1B,UD3C0B,CC2Cf,OD3Ce,EC2CN,UD3CM,CC2CK,aD3CL,CC2CmB,ED3CnB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,MAAA,CAAA,EAAA,EAAA,EC4C1B,ED5C0B,EAAA,IAAA,EC6CxB,UD7CwB,CC6Cb,aD7Ca,CC6CC,ED7CD,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,IAAA;EAAvB,KAAA,CAAA,WAAA,ECmDW,sBDnDX,EAAA,OAAA,ECmD4C,mBDnD5C,CCmDgE,MDnDhE,EAAA,IAAA,CAAA,CAAA,EAAA,IAAA;EAAsB,QAAA,CAAA,WAAA,MCiEJ,aDjEI,GAAA,MAAA,CAAA,CAAA,KAAA,ECmE1B,qBDnE0B,CCmEJ,ODnEI,ECmEK,UDnEL,CCmEgB,aDnEhB,CCmE8B,EDnE9B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CCoEzB,UDpEyB,CCoEd,ODpEc,ECoEL,UDpEK,CCoEM,aDpEN,CCoEoB,EDpEpB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,MAAA,CAAA,EAAA,EAAA,ECqEzB,EDrEyB,EAAA,IAAA,ECsEvB,UDtEuB,CCsEZ,aDtEY,CCsEE,EDtEF,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,IAAA;EAInB,KAAA,CAAA,CAAA,EAAA;IACI,MAAA,EC0EN,uBD1EM,CC0EkB,aD1ElB,EC0EiC,OD1EjC,CAAA,GAAA,IAAA;IAC2B,KAAA,EC0ElC,sBD1EkC,CC0EX,OD1EW,CAAA,EAAA,GAAA,IAAA;EAApB,CAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../types.ts","../DefaultChimeraQueryBuilder.ts","../factory.ts"],"sourcesContent":[],"mappings":";;;UASiB,mCAAmC;;EAAnC,MAAA,EAAA,EAAA,IAAA;EAAmC,KAAA,EAAA,EAAA;IAMa,MAAA,EAAvD,uBAAuD,CAA/B,8BAA+B,CAAA,MAAA,CAAA,EAAS,wBAAT,CAAkC,MAAlC,CAAA,CAAA,GAAA,IAAA;IAA/B,KAAA,EACzB,sBADyB,CACF,wBADE,CACuB,MADvB,CAAA,CAAA,EAAA,GAAA,IAAA;EAAiE,CAAA;;AAAzF,KAKE,mBALF,CAAA,eAMM,qBANN,EAAA,sBAOa,mBAPb,CAOiC,MAPjC,CAAA,GAO2C,mBAP3C,CAO+D,MAP/D,CAAA,CAAA,GAAA,CAAA,CAAA,EAQF,aARE,EAAA,GAQgB,OARhB,CAQwB,mBARxB,CAQ4C,MAR5C,CAAA,CAAA;;;cCKG,0CACG,uCACC,yBAAyB,UAAU,yBAAyB,+BACtD,+BAA+B,UAAU,+BAA+B,oBAClF,oBAAoB;EDfhB,QAAA,UAAA;EAAmC,qBAAA,EAAA,IAAA;EAMa,MAAA,CAAA,CAAA,EAAA,IAAA;EAA/B,OAAA,CAAA,GAAA,ECoB3B,qBDpB2B,CCoBL,ODpBK,CAAA,GAAA,CAAA,MCoBa,ODpBb,GAAA,MAAA,CAAA,EAAA,IAAA,CAAA,EAAA,OAAA,EAAA,KAAA,CAAA,ECsBzB,iBDtByB,CAAA,EAAA,IAAA;EAAiE,QAAA,OAAA;EAAzB,QAAA,eAAA;EAAhE,QAAA,WAAA;EAC+C,QAAA,WAAA;EAAzB,KAAA,CAAA,WAAA,MCwCR,aDxCQ,GAAA,MAAA,CAAA,CAAA,KAAA,EC0C3B,qBD1C2B,CC0CL,OD1CK,EC0CI,UD1CJ,CC0Ce,aD1Cf,CC0C6B,ED1C7B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CC2C1B,UD3C0B,CC2Cf,OD3Ce,EC2CN,UD3CM,CC2CK,aD3CL,CC2CmB,ED3CnB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,MAAA,CAAA,EAAA,EAAA,EC4C1B,ED5C0B,EAAA,IAAA,EC6CxB,UD7CwB,CC6Cb,aD7Ca,CC6CC,ED7CD,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,IAAA;EAAvB,KAAA,CAAA,WAAA,ECmDW,sBDnDX,EAAA,OAAA,ECmD4C,mBDnD5C,CCmDgE,MDnDhE,EAAA,IAAA,CAAA,CAAA,EAAA,IAAA;EAAsB,QAAA,CAAA,WAAA,MCiEJ,aDjEI,GAAA,MAAA,CAAA,CAAA,KAAA,ECmE1B,qBDnE0B,CCmEJ,ODnEI,ECmEK,UDnEL,CCmEgB,aDnEhB,CCmE8B,EDnE9B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CCoEzB,UDpEyB,CCoEd,ODpEc,ECoEL,UDpEK,CCoEM,aDpEN,CCoEoB,EDpEpB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,MAAA,CAAA,EAAA,EAAA,ECqEzB,EDrEyB,EAAA,IAAA,ECsEvB,UDtEuB,CCsEZ,aDtEY,CCsEE,EDtEF,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,IAAA;EAInB,KAAA,CAAA,CAAA,EAAA;IACI,MAAA,EC0EN,uBD1EM,CC0EkB,aD1ElB,EC0EiC,OD1EjC,CAAA,GAAA,IAAA;IAC2B,KAAA,EC0ElC,sBD1EkC,CC0EX,OD1EW,CAAA,EAAA,GAAA,IAAA;EAApB,CAAA;;;;iBEnBP,yCAAyC,0BAA0B,2BAA2B"}

package/dist/index.mjs

@@ -45,5 +45,11 @@ var DefaultChimeraQueryBuilder = class {
 };
 
 //#endregion
-export { DefaultChimeraQueryBuilder };
+//#region factory.ts
+function createDefaultQueryBuilder() {
+	return new DefaultChimeraQueryBuilder();
+}
+
+//#endregion
+export { DefaultChimeraQueryBuilder, createDefaultQueryBuilder };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../DefaultChimeraQueryBuilder.ts"],"sourcesContent":["import {\n\ttype AnyChimeraEntityStore,\n\ttype ChimeraConjunctionDescriptor,\n\ttype ChimeraConjunctionOperationDescriptor,\n\ttype ChimeraConjunctionType,\n\ttype ChimeraEntityStoreEntity,\n\ttype ChimeraEntityStoreOperatorsMap,\n\ttype ChimeraFilterDescriptor,\n\ttype ChimeraOrderDescriptor,\n\tChimeraOrderNulls,\n\ttype ChimeraPropertyGetter,\n\ttype Constructable,\n\tchimeraCreateConjunction,\n\tchimeraCreateNot,\n\tchimeraCreateOperator,\n\tchimeraCreateOrderBy,\n\ttype KeysOfType,\n} from \"@hf-chimera/store\";\nimport type { ChimeraQueryBuilder, QueryBuilderCreator } from \"./types\";\n\nexport class DefaultChimeraQueryBuilder<\n\tTStore extends AnyChimeraEntityStore,\n\tTEntity extends ChimeraEntityStoreEntity<TStore> = ChimeraEntityStoreEntity<TStore>,\n\tTOperatorsMap extends ChimeraEntityStoreOperatorsMap<TStore> = ChimeraEntityStoreOperatorsMap<TStore>,\n> implements ChimeraQueryBuilder<TStore>\n{\n\tprivate orderRules: ChimeraOrderDescriptor<TEntity>[] = [];\n\n\tisChimeraQueryBuilder: true = true;\n\n\tcreate(): this {\n\t\treturn new (this.constructor as Constructable)();\n\t}\n\n\torderBy(\n\t\tkey: ChimeraPropertyGetter<TEntity> | (keyof TEntity & string),\n\t\tdesc = false,\n\t\tnulls: ChimeraOrderNulls = ChimeraOrderNulls.Last,\n\t): this {\n\t\tthis.orderRules.push(chimeraCreateOrderBy<TEntity>(key, desc, nulls));\n\t\treturn this;\n\t}\n\n\tprivate filters: ChimeraConjunctionOperationDescriptor<TOperatorsMap, TEntity>[] = [];\n\tprivate rootConjunction: Exclude<ChimeraConjunctionType, \"not\"> = \"and\";\n\n\tprivate conjunction(type: Exclude<ChimeraConjunctionType, \"not\">) {\n\t\tthis.rootConjunction = type;\n\t}\n\n\tprivate buildFilter(): ChimeraConjunctionDescriptor<TOperatorsMap, TEntity> | null {\n\t\treturn this.filters.length\n\t\t\t? chimeraCreateConjunction<TEntity, TOperatorsMap>(this.rootConjunction, this.filters)\n\t\t\t: null;\n\t}\n\n\twhere<Op extends keyof TOperatorsMap & string>(\n\t\tvalue:\n\t\t\t| ChimeraPropertyGetter<TEntity, Parameters<TOperatorsMap[Op]>[0]>\n\t\t\t| (KeysOfType<TEntity, Parameters<TOperatorsMap[Op]>[0]> & string),\n\t\top: Op,\n\t\ttest: Parameters<TOperatorsMap[Op]>[1],\n\t): this {\n\t\tthis.filters.push(chimeraCreateOperator<TEntity, TOperatorsMap, Op>(op, value, test));\n\t\treturn this;\n\t}\n\n\tgroup(conjunction: ChimeraConjunctionType, builder: QueryBuilderCreator<TStore, this>): this {\n\t\tconst isNot = conjunction === \"not\";\n\t\tconst nestedBuilder = this.create();\n\n\t\t!isNot && nestedBuilder.conjunction(conjunction);\n\n\t\tbuilder(nestedBuilder);\n\n\t\tconst nestedQuery = nestedBuilder.buildFilter();\n\t\tnestedQuery && this.filters.push(isNot ? chimeraCreateNot<TEntity, TOperatorsMap>(nestedQuery) : nestedQuery);\n\n\t\treturn this;\n\t}\n\n\twhereNot<Op extends keyof TOperatorsMap & string>(\n\t\tvalue:\n\t\t\t| ChimeraPropertyGetter<TEntity, Parameters<TOperatorsMap[Op]>[0]>\n\t\t\t| (KeysOfType<TEntity, Parameters<TOperatorsMap[Op]>[0]> & string),\n\t\top: Op,\n\t\ttest: Parameters<TOperatorsMap[Op]>[1],\n\t): this {\n\t\tthis.filters.push(\n\t\t\tchimeraCreateNot<TEntity, TOperatorsMap>(chimeraCreateOperator<TEntity, TOperatorsMap, Op>(op, value, test)),\n\t\t);\n\t\treturn this;\n\t}\n\n\tbuild(): {\n\t\tfilter: ChimeraFilterDescriptor<TOperatorsMap, TEntity> | null;\n\t\torder: ChimeraOrderDescriptor<TEntity>[] | null;\n\t} {\n\t\treturn {\n\t\t\tfilter: this.buildFilter(),\n\t\t\torder: this.orderRules.length ? this.orderRules : null,\n\t\t};\n\t}\n}\n"],"mappings":";;;AAoBA,IAAa,6BAAb,MAKA;CACC,AAAQ,aAAgD,EAAE;CAE1D,wBAA8B;CAE9B,SAAe;AACd,SAAO,IAAK,KAAK,aAA+B;;CAGjD,QACC,KACA,OAAO,OACP,QAA2B,kBAAkB,MACtC;AACP,OAAK,WAAW,KAAK,qBAA8B,KAAK,MAAM,MAAM,CAAC;AACrE,SAAO;;CAGR,AAAQ,UAA2E,EAAE;CACrF,AAAQ,kBAA0D;CAElE,AAAQ,YAAY,MAA8C;AACjE,OAAK,kBAAkB;;CAGxB,AAAQ,cAA2E;AAClF,SAAO,KAAK,QAAQ,SACjB,yBAAiD,KAAK,iBAAiB,KAAK,QAAQ,GACpF;;CAGJ,MACC,OAGA,IACA,MACO;AACP,OAAK,QAAQ,KAAK,sBAAkD,IAAI,OAAO,KAAK,CAAC;AACrF,SAAO;;CAGR,MAAM,aAAqC,SAAkD;EAC5F,MAAM,QAAQ,gBAAgB;EAC9B,MAAM,gBAAgB,KAAK,QAAQ;AAEnC,GAAC,SAAS,cAAc,YAAY,YAAY;AAEhD,UAAQ,cAAc;EAEtB,MAAM,cAAc,cAAc,aAAa;AAC/C,iBAAe,KAAK,QAAQ,KAAK,QAAQ,iBAAyC,YAAY,GAAG,YAAY;AAE7G,SAAO;;CAGR,SACC,OAGA,IACA,MACO;AACP,OAAK,QAAQ,KACZ,iBAAyC,sBAAkD,IAAI,OAAO,KAAK,CAAC,CAC5G;AACD,SAAO;;CAGR,QAGE;AACD,SAAO;GACN,QAAQ,KAAK,aAAa;GAC1B,OAAO,KAAK,WAAW,SAAS,KAAK,aAAa;GAClD"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../DefaultChimeraQueryBuilder.ts","../factory.ts"],"sourcesContent":["import {\n\ttype AnyChimeraEntityStore,\n\ttype ChimeraConjunctionDescriptor,\n\ttype ChimeraConjunctionOperationDescriptor,\n\ttype ChimeraConjunctionType,\n\ttype ChimeraEntityStoreEntity,\n\ttype ChimeraEntityStoreOperatorsMap,\n\ttype ChimeraFilterDescriptor,\n\ttype ChimeraOrderDescriptor,\n\tChimeraOrderNulls,\n\ttype ChimeraPropertyGetter,\n\ttype Constructable,\n\tchimeraCreateConjunction,\n\tchimeraCreateNot,\n\tchimeraCreateOperator,\n\tchimeraCreateOrderBy,\n\ttype KeysOfType,\n} from \"@hf-chimera/store\";\nimport type { ChimeraQueryBuilder, QueryBuilderCreator } from \"./types\";\n\nexport class DefaultChimeraQueryBuilder<\n\tTStore extends AnyChimeraEntityStore,\n\tTEntity extends ChimeraEntityStoreEntity<TStore> = ChimeraEntityStoreEntity<TStore>,\n\tTOperatorsMap extends ChimeraEntityStoreOperatorsMap<TStore> = ChimeraEntityStoreOperatorsMap<TStore>,\n> implements ChimeraQueryBuilder<TStore>\n{\n\tprivate orderRules: ChimeraOrderDescriptor<TEntity>[] = [];\n\n\tisChimeraQueryBuilder: true = true;\n\n\tcreate(): this {\n\t\treturn new (this.constructor as Constructable)();\n\t}\n\n\torderBy(\n\t\tkey: ChimeraPropertyGetter<TEntity> | (keyof TEntity & string),\n\t\tdesc = false,\n\t\tnulls: ChimeraOrderNulls = ChimeraOrderNulls.Last,\n\t): this {\n\t\tthis.orderRules.push(chimeraCreateOrderBy<TEntity>(key, desc, nulls));\n\t\treturn this;\n\t}\n\n\tprivate filters: ChimeraConjunctionOperationDescriptor<TOperatorsMap, TEntity>[] = [];\n\tprivate rootConjunction: Exclude<ChimeraConjunctionType, \"not\"> = \"and\";\n\n\tprivate conjunction(type: Exclude<ChimeraConjunctionType, \"not\">) {\n\t\tthis.rootConjunction = type;\n\t}\n\n\tprivate buildFilter(): ChimeraConjunctionDescriptor<TOperatorsMap, TEntity> | null {\n\t\treturn this.filters.length\n\t\t\t? chimeraCreateConjunction<TEntity, TOperatorsMap>(this.rootConjunction, this.filters)\n\t\t\t: null;\n\t}\n\n\twhere<Op extends keyof TOperatorsMap & string>(\n\t\tvalue:\n\t\t\t| ChimeraPropertyGetter<TEntity, Parameters<TOperatorsMap[Op]>[0]>\n\t\t\t| (KeysOfType<TEntity, Parameters<TOperatorsMap[Op]>[0]> & string),\n\t\top: Op,\n\t\ttest: Parameters<TOperatorsMap[Op]>[1],\n\t): this {\n\t\tthis.filters.push(chimeraCreateOperator<TEntity, TOperatorsMap, Op>(op, value, test));\n\t\treturn this;\n\t}\n\n\tgroup(conjunction: ChimeraConjunctionType, builder: QueryBuilderCreator<TStore, this>): this {\n\t\tconst isNot = conjunction === \"not\";\n\t\tconst nestedBuilder = this.create();\n\n\t\t!isNot && nestedBuilder.conjunction(conjunction);\n\n\t\tbuilder(nestedBuilder);\n\n\t\tconst nestedQuery = nestedBuilder.buildFilter();\n\t\tnestedQuery && this.filters.push(isNot ? chimeraCreateNot<TEntity, TOperatorsMap>(nestedQuery) : nestedQuery);\n\n\t\treturn this;\n\t}\n\n\twhereNot<Op extends keyof TOperatorsMap & string>(\n\t\tvalue:\n\t\t\t| ChimeraPropertyGetter<TEntity, Parameters<TOperatorsMap[Op]>[0]>\n\t\t\t| (KeysOfType<TEntity, Parameters<TOperatorsMap[Op]>[0]> & string),\n\t\top: Op,\n\t\ttest: Parameters<TOperatorsMap[Op]>[1],\n\t): this {\n\t\tthis.filters.push(\n\t\t\tchimeraCreateNot<TEntity, TOperatorsMap>(chimeraCreateOperator<TEntity, TOperatorsMap, Op>(op, value, test)),\n\t\t);\n\t\treturn this;\n\t}\n\n\tbuild(): {\n\t\tfilter: ChimeraFilterDescriptor<TOperatorsMap, TEntity> | null;\n\t\torder: ChimeraOrderDescriptor<TEntity>[] | null;\n\t} {\n\t\treturn {\n\t\t\tfilter: this.buildFilter(),\n\t\t\torder: this.orderRules.length ? this.orderRules : null,\n\t\t};\n\t}\n}\n","import type { AnyChimeraEntityStore } from \"@hf-chimera/store\";\nimport { DefaultChimeraQueryBuilder } from \"./DefaultChimeraQueryBuilder\";\n\nexport function createDefaultQueryBuilder<TStore extends AnyChimeraEntityStore>(): DefaultChimeraQueryBuilder<TStore> {\n\treturn new DefaultChimeraQueryBuilder<TStore>();\n}\n"],"mappings":";;;AAoBA,IAAa,6BAAb,MAKA;CACC,AAAQ,aAAgD,EAAE;CAE1D,wBAA8B;CAE9B,SAAe;AACd,SAAO,IAAK,KAAK,aAA+B;;CAGjD,QACC,KACA,OAAO,OACP,QAA2B,kBAAkB,MACtC;AACP,OAAK,WAAW,KAAK,qBAA8B,KAAK,MAAM,MAAM,CAAC;AACrE,SAAO;;CAGR,AAAQ,UAA2E,EAAE;CACrF,AAAQ,kBAA0D;CAElE,AAAQ,YAAY,MAA8C;AACjE,OAAK,kBAAkB;;CAGxB,AAAQ,cAA2E;AAClF,SAAO,KAAK,QAAQ,SACjB,yBAAiD,KAAK,iBAAiB,KAAK,QAAQ,GACpF;;CAGJ,MACC,OAGA,IACA,MACO;AACP,OAAK,QAAQ,KAAK,sBAAkD,IAAI,OAAO,KAAK,CAAC;AACrF,SAAO;;CAGR,MAAM,aAAqC,SAAkD;EAC5F,MAAM,QAAQ,gBAAgB;EAC9B,MAAM,gBAAgB,KAAK,QAAQ;AAEnC,GAAC,SAAS,cAAc,YAAY,YAAY;AAEhD,UAAQ,cAAc;EAEtB,MAAM,cAAc,cAAc,aAAa;AAC/C,iBAAe,KAAK,QAAQ,KAAK,QAAQ,iBAAyC,YAAY,GAAG,YAAY;AAE7G,SAAO;;CAGR,SACC,OAGA,IACA,MACO;AACP,OAAK,QAAQ,KACZ,iBAAyC,sBAAkD,IAAI,OAAO,KAAK,CAAC,CAC5G;AACD,SAAO;;CAGR,QAGE;AACD,SAAO;GACN,QAAQ,KAAK,aAAa;GAC1B,OAAO,KAAK,WAAW,SAAS,KAAK,aAAa;GAClD;;;;;;AClGH,SAAgB,4BAAsG;AACrH,QAAO,IAAI,4BAAoC"}

package/package.json

@@ -1,45 +1,45 @@
 {
-	"name": "@hf-chimera/query-builder",
-	"version": "0.2.0",
-	"description": "Cross-end reactivity API - Query builder",
-	"license": "MIT",
-	"author": "hewston",
-	"keywords": [
-		"query-builder",
-		"reactivity",
-		"reactive",
-		"typescript",
-		"fullstack"
-	],
-	"type": "module",
-	"types": "./dist/index.d.ts",
-	"main": "./dist/index.cjs",
-	"module": "./dist/index.js",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"require": "./dist/index.cjs",
-			"import": "./dist/index.js"
-		}
-	},
-	"files": [
-		"dist"
-	],
-	"bugs": {
-		"url": "https://github.com/hf-chimera/store/issues"
-	},
-	"repository": {
-		"url": "https://github.com/hf-chimera/store"
-	},
-	"peerDependencies": {
-		"@hf-chimera/store": "workspace:^"
-	},
-	"scripts": {
-		"build": "tsdown",
-		"changeset:patch": "node ../../scripts/changeset-patch.mjs @hf-chimera/query-builder"
-	},
-	"publishConfig": {
-		"access": "public",
-		"provenance": true
-	}
-}
+  "name": "@hf-chimera/query-builder",
+  "version": "0.2.2",
+  "description": "Cross-end reactivity API - Query builder",
+  "license": "MIT",
+  "author": "hewston",
+  "keywords": [
+    "query-builder",
+    "reactivity",
+    "reactive",
+    "typescript",
+    "fullstack"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "bugs": {
+    "url": "https://github.com/hf-chimera/store/issues"
+  },
+  "repository": {
+    "url": "https://github.com/hf-chimera/store"
+  },
+  "peerDependencies": {
+    "@hf-chimera/store": "~0.2.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsdown",
+    "changeset:patch": "node ../../scripts/changeset-patch.mjs @hf-chimera/query-builder"
+  }
+}