@hf-chimera/query-builder 0.2.0

package/README.md

@@ -0,0 +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 }`

package/dist/index.cjs

@@ -0,0 +1,49 @@
+let _hf_chimera_store = require("@hf-chimera/store");
+
+//#region DefaultChimeraQueryBuilder.ts
+var DefaultChimeraQueryBuilder = class {
+	orderRules = [];
+	isChimeraQueryBuilder = true;
+	create() {
+		return new this.constructor();
+	}
+	orderBy(key, desc = false, nulls = _hf_chimera_store.ChimeraOrderNulls.Last) {
+		this.orderRules.push((0, _hf_chimera_store.chimeraCreateOrderBy)(key, desc, nulls));
+		return this;
+	}
+	filters = [];
+	rootConjunction = "and";
+	conjunction(type) {
+		this.rootConjunction = type;
+	}
+	buildFilter() {
+		return this.filters.length ? (0, _hf_chimera_store.chimeraCreateConjunction)(this.rootConjunction, this.filters) : null;
+	}
+	where(value, op, test) {
+		this.filters.push((0, _hf_chimera_store.chimeraCreateOperator)(op, value, test));
+		return this;
+	}
+	group(conjunction, builder) {
+		const isNot = conjunction === "not";
+		const nestedBuilder = this.create();
+		!isNot && nestedBuilder.conjunction(conjunction);
+		builder(nestedBuilder);
+		const nestedQuery = nestedBuilder.buildFilter();
+		nestedQuery && this.filters.push(isNot ? (0, _hf_chimera_store.chimeraCreateNot)(nestedQuery) : nestedQuery);
+		return this;
+	}
+	whereNot(value, op, test) {
+		this.filters.push((0, _hf_chimera_store.chimeraCreateNot)((0, _hf_chimera_store.chimeraCreateOperator)(op, value, test)));
+		return this;
+	}
+	build() {
+		return {
+			filter: this.buildFilter(),
+			order: this.orderRules.length ? this.orderRules : null
+		};
+	}
+};
+
+//#endregion
+exports.DefaultChimeraQueryBuilder = DefaultChimeraQueryBuilder;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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"}

package/dist/index.d.cts

@@ -0,0 +1,34 @@
+import { AnyChimeraEntityStore, ChimeraConjunctionType, ChimeraEntityStoreEntity, ChimeraEntityStoreOperatorsMap, ChimeraFilterDescriptor, ChimeraOrderDescriptor, ChimeraOrderNulls, ChimeraPropertyGetter, KeysOfType, Nullish } from "@hf-chimera/store";
+
+//#region types.d.ts
+interface ChimeraQueryBuilder<TStore extends AnyChimeraEntityStore> {
+  isChimeraQueryBuilder: true;
+  create(): this;
+  build(): {
+    filter: ChimeraFilterDescriptor<ChimeraEntityStoreOperatorsMap<TStore>, ChimeraEntityStoreEntity<TStore>> | null;
+    order: ChimeraOrderDescriptor<ChimeraEntityStoreEntity<TStore>>[] | null;
+  };
+}
+type QueryBuilderCreator<TStore extends AnyChimeraEntityStore, TQueryBuilder extends ChimeraQueryBuilder<TStore> = ChimeraQueryBuilder<TStore>> = (q: TQueryBuilder) => Nullish<ChimeraQueryBuilder<TStore>>;
+//#endregion
+//#region DefaultChimeraQueryBuilder.d.ts
+declare class DefaultChimeraQueryBuilder<TStore extends AnyChimeraEntityStore, TEntity extends ChimeraEntityStoreEntity<TStore> = ChimeraEntityStoreEntity<TStore>, TOperatorsMap extends ChimeraEntityStoreOperatorsMap<TStore> = ChimeraEntityStoreOperatorsMap<TStore>> implements ChimeraQueryBuilder<TStore> {
+  private orderRules;
+  isChimeraQueryBuilder: true;
+  create(): this;
+  orderBy(key: ChimeraPropertyGetter<TEntity> | (keyof TEntity & string), desc?: boolean, nulls?: ChimeraOrderNulls): this;
+  private filters;
+  private rootConjunction;
+  private conjunction;
+  private buildFilter;
+  where<Op extends keyof TOperatorsMap & string>(value: ChimeraPropertyGetter<TEntity, Parameters<TOperatorsMap[Op]>[0]> | (KeysOfType<TEntity, Parameters<TOperatorsMap[Op]>[0]> & string), op: Op, test: Parameters<TOperatorsMap[Op]>[1]): this;
+  group(conjunction: ChimeraConjunctionType, builder: QueryBuilderCreator<TStore, this>): this;
+  whereNot<Op extends keyof TOperatorsMap & string>(value: ChimeraPropertyGetter<TEntity, Parameters<TOperatorsMap[Op]>[0]> | (KeysOfType<TEntity, Parameters<TOperatorsMap[Op]>[0]> & string), op: Op, test: Parameters<TOperatorsMap[Op]>[1]): this;
+  build(): {
+    filter: ChimeraFilterDescriptor<TOperatorsMap, TEntity> | null;
+    order: ChimeraOrderDescriptor<TEntity>[] | null;
+  };
+}
+//#endregion
+export { type ChimeraQueryBuilder, DefaultChimeraQueryBuilder, type QueryBuilderCreator };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +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"}

package/dist/index.d.mts

@@ -0,0 +1,34 @@
+import { AnyChimeraEntityStore, ChimeraConjunctionType, ChimeraEntityStoreEntity, ChimeraEntityStoreOperatorsMap, ChimeraFilterDescriptor, ChimeraOrderDescriptor, ChimeraOrderNulls, ChimeraPropertyGetter, KeysOfType, Nullish } from "@hf-chimera/store";
+
+//#region types.d.ts
+interface ChimeraQueryBuilder<TStore extends AnyChimeraEntityStore> {
+  isChimeraQueryBuilder: true;
+  create(): this;
+  build(): {
+    filter: ChimeraFilterDescriptor<ChimeraEntityStoreOperatorsMap<TStore>, ChimeraEntityStoreEntity<TStore>> | null;
+    order: ChimeraOrderDescriptor<ChimeraEntityStoreEntity<TStore>>[] | null;
+  };
+}
+type QueryBuilderCreator<TStore extends AnyChimeraEntityStore, TQueryBuilder extends ChimeraQueryBuilder<TStore> = ChimeraQueryBuilder<TStore>> = (q: TQueryBuilder) => Nullish<ChimeraQueryBuilder<TStore>>;
+//#endregion
+//#region DefaultChimeraQueryBuilder.d.ts
+declare class DefaultChimeraQueryBuilder<TStore extends AnyChimeraEntityStore, TEntity extends ChimeraEntityStoreEntity<TStore> = ChimeraEntityStoreEntity<TStore>, TOperatorsMap extends ChimeraEntityStoreOperatorsMap<TStore> = ChimeraEntityStoreOperatorsMap<TStore>> implements ChimeraQueryBuilder<TStore> {
+  private orderRules;
+  isChimeraQueryBuilder: true;
+  create(): this;
+  orderBy(key: ChimeraPropertyGetter<TEntity> | (keyof TEntity & string), desc?: boolean, nulls?: ChimeraOrderNulls): this;
+  private filters;
+  private rootConjunction;
+  private conjunction;
+  private buildFilter;
+  where<Op extends keyof TOperatorsMap & string>(value: ChimeraPropertyGetter<TEntity, Parameters<TOperatorsMap[Op]>[0]> | (KeysOfType<TEntity, Parameters<TOperatorsMap[Op]>[0]> & string), op: Op, test: Parameters<TOperatorsMap[Op]>[1]): this;
+  group(conjunction: ChimeraConjunctionType, builder: QueryBuilderCreator<TStore, this>): this;
+  whereNot<Op extends keyof TOperatorsMap & string>(value: ChimeraPropertyGetter<TEntity, Parameters<TOperatorsMap[Op]>[0]> | (KeysOfType<TEntity, Parameters<TOperatorsMap[Op]>[0]> & string), op: Op, test: Parameters<TOperatorsMap[Op]>[1]): this;
+  build(): {
+    filter: ChimeraFilterDescriptor<TOperatorsMap, TEntity> | null;
+    order: ChimeraOrderDescriptor<TEntity>[] | null;
+  };
+}
+//#endregion
+export { type ChimeraQueryBuilder, DefaultChimeraQueryBuilder, type QueryBuilderCreator };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +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"}

package/dist/index.mjs

@@ -0,0 +1,49 @@
+import { ChimeraOrderNulls, chimeraCreateConjunction, chimeraCreateNot, chimeraCreateOperator, chimeraCreateOrderBy } from "@hf-chimera/store";
+
+//#region DefaultChimeraQueryBuilder.ts
+var DefaultChimeraQueryBuilder = class {
+	orderRules = [];
+	isChimeraQueryBuilder = true;
+	create() {
+		return new this.constructor();
+	}
+	orderBy(key, desc = false, nulls = ChimeraOrderNulls.Last) {
+		this.orderRules.push(chimeraCreateOrderBy(key, desc, nulls));
+		return this;
+	}
+	filters = [];
+	rootConjunction = "and";
+	conjunction(type) {
+		this.rootConjunction = type;
+	}
+	buildFilter() {
+		return this.filters.length ? chimeraCreateConjunction(this.rootConjunction, this.filters) : null;
+	}
+	where(value, op, test) {
+		this.filters.push(chimeraCreateOperator(op, value, test));
+		return this;
+	}
+	group(conjunction, builder) {
+		const isNot = conjunction === "not";
+		const nestedBuilder = this.create();
+		!isNot && nestedBuilder.conjunction(conjunction);
+		builder(nestedBuilder);
+		const nestedQuery = nestedBuilder.buildFilter();
+		nestedQuery && this.filters.push(isNot ? chimeraCreateNot(nestedQuery) : nestedQuery);
+		return this;
+	}
+	whereNot(value, op, test) {
+		this.filters.push(chimeraCreateNot(chimeraCreateOperator(op, value, test)));
+		return this;
+	}
+	build() {
+		return {
+			filter: this.buildFilter(),
+			order: this.orderRules.length ? this.orderRules : null
+		};
+	}
+};
+
+//#endregion
+export { DefaultChimeraQueryBuilder };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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"}

package/package.json

@@ -0,0 +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
+	}
+}