uql-orm 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -3,13 +3,9 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## [0.2.2](https://github.com/rogerpadilla/uql/compare/uql-orm@0.2.1...uql-orm@0.2.2) (2026-03-09)
+## [0.2.3](https://github.com/rogerpadilla/uql/compare/uql-orm@0.2.2...uql-orm@0.2.3) (2026-03-09)
 
-
-### Features
-
-* implement aggregate query API with `$group`, `$having`, and `$distinct` support, accompanied by sorting bug fixes and extensive code refactoring. ([fa90ee9](https://github.com/rogerpadilla/uql/commit/fa90ee9313645179c4d7d1ec2e4ec291dfe7285b))
-* Introduce aggregate query support with `GROUP BY`, `HAVING`, `$count`, `$sum`, `$avg`, `$min`, `$max`, and `DISTINCT` across all dialects. ([2ba02e9](https://github.com/rogerpadilla/uql/commit/2ba02e9070c8a457a651507cd55ee8e94e22819e))
+**Note:** Version bump only for package uql-orm
 
 
 
@@ -21,6 +17,13 @@ All notable changes to this project will be documented in this file. Please add
 
 date format is [yyyy-mm-dd]
 
+## [0.2.3] - 2026-03-09
+### Documentation
+- **Aggregate Queries guide**: Added dedicated [aggregate documentation page](https://uql-orm.dev/querying/aggregate) covering `$group`, `$having`, `$where` vs `$having`, sorting/pagination, and `$distinct`.
+- **README**: Added Aggregate Queries to features table, new §4 subsection with code examples and generated SQL, and "Learn more" link.
+- **Querier methods table**: Added `aggregate()` to the website's querier reference.
+- **Simplified tsconfig**: Removed `module`/`target` from recommended config — only decorator flags are UQL-specific. Added Pure ESM note.
+
 ## [0.2.2] - 2026-03-09
 ### New Features
 - **Aggregate Query API**: Added `querier.aggregate()` with full support across all SQL dialects and MongoDB. Includes typed `QueryAggregate<E>`, `QueryGroupMap`, `QueryHavingMap`, and `QueryAggregateOp` types. Supports `$group` (with `$count`, `$sum`, `$avg`, `$min`, `$max`), `$having` (post-aggregation filtering with operator support), `$where` (pre-aggregation filtering), `$sort`, `$skip`, and `$limit`.
@@ -37,7 +40,7 @@ date format is [yyyy-mm-dd]
 
 ### Bug Fixes
 - **Sort direction with numeric `-1`**: `SORT_DIRECTION_MAP` only had the string key `'-1'`, not the numeric `-1` from `QuerySortDirection`. Queries using `$sort: { field: -1 }` silently produced ascending order. Now both numeric and string forms work correctly.
-- **MongoDB sort normalization**: `buildAggregateStages` passed raw string directions (`'asc'`/`'desc'`) to MongoDB's `$sort` stage, which only understands numeric `1`/`-1`. Extracted `buildMongoSort()` helper that normalizes all direction values.
+- **MongoDB sort normalization**: Unified sort direction normalization into `sort()` method, ensuring all callers (find queries and aggregate pipelines) normalize string directions (`'asc'`/`'desc'`) to numeric `1`/`-1` for the MongoDB server.
 
 ### Type Safety
 - **`QueryAggregateFn` enforces single operation**: Changed from a mapped type (which allowed invalid `{ $count: '*', $sum: 'amount' }`) to a discriminated union that enforces exactly one aggregate op per entry.
@@ -57,6 +60,11 @@ date format is [yyyy-mm-dd]
 - **`insertRelations` cleanup**: Replaced `.map()` with implicit undefined return with `.filter().map()` pattern.
 - **Dead code removal**: Removed dead `Array.isArray` branch in `fillToManyRelations` (array-based `$select` was removed in 3.14.0), dead `Promise.resolve()` in async context, unused generic type parameter.
 - **`havingCondition` visibility**: Changed from `private` to `protected` to allow dialect subclass overrides.
+- **`insertRelations` DRY**: Eliminated double `filterPersistableRelationKeys` call per item using a single `.reduce()` pass.
+- **`where()` loop**: Replaced `.reduce()` accumulator in MongoDB `where()` with a cleaner `for...of` loop.
+- **`_id` constant**: Extracted repeated `'_id'` string literal to `MongoDialect.ID_KEY` class constant.
+- **`negateOperatorMap` static**: Promoted per-call `negateOperatorMap` allocation in `compareLogicalOperator` to `static readonly NEGATE_OP_MAP`.
+- **`AGGREGATE_OP_MAP` class-level**: Moved module-level `MONGO_AGGREGATE_OP_MAP` to `MongoDialect.AGGREGATE_OP_MAP` static, consistent with `REGEX_OP_MAP` and `NATIVE_OPS`.
 
 ### Test Coverage
 - Added comprehensive tests for `aggregate()` (all SQL dialects + MongoDB pipeline stages), HAVING `$in`/`$nin`/`$isNull`/`$isNotNull`, sort with numeric `-1`, mixed sort directions, MongoDB string-to-numeric sort normalization, aggregate pagination, `parseGroupMap` (edge cases), and `deleteMany` dual-API pattern. All coverage thresholds met.

package/README.md

@@ -66,14 +66,12 @@ Ensure your `tsconfig.json` is configured to support decorators and metadata:
 {
   "compilerOptions": {
     "experimentalDecorators": true,
-    "emitDecoratorMetadata": true,
-    "module": "NodeNext",
-    "target": "ESNext"
+    "emitDecoratorMetadata": true
   }
 }
 ```
 
- **Note:** `ES2020+` will work for `target` as well.
+ **Note:** UQL is Pure ESM — ensure your project's `module` supports ESM imports (e.g., `NodeNext`, `ESNext`, `Bundler`).
 
 ## 2. Define the Entities
 

package/package.json

@@ -3,7 +3,7 @@
   "homepage": "https://uql-orm.dev",
   "description": "One Language. Frontend to Backend.",
   "license": "MIT",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -105,7 +105,7 @@
     "express": "^5.2.1",
     "mariadb": "^3.5.2",
     "mongodb": "^7.1.0",
-    "mysql2": "^3.19.0",
+    "mysql2": "^3.19.1",
     "pg": "^8.20.0"
   },
   "author": "Roger Padilla",
@@ -142,5 +142,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "ed4d31bb11847427886f7c11775ab5bdd8736567"
+  "gitHead": "090cb43fa837e421b6bfffaba30902bb90e349c4"
 }