uql-orm 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -3,12 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-# [0.3.0](https://github.com/rogerpadilla/uql/compare/uql-orm@0.2.10...uql-orm@0.3.0) (2026-03-12)
+## [0.3.2](https://github.com/rogerpadilla/uql/compare/uql-orm@0.3.1...uql-orm@0.3.2) (2026-03-12)
 
 
 ### Features
 
-* vector index support with dialect-driven schema generation ([5bb1a6e](https://github.com/rogerpadilla/uql/commit/5bb1a6e99ae9108dad492630c55cf3ba15862a3c))
+* add  to  and implement  created/updated detection for MongoDB, MariaDB, MySQL, and PostgreSQL ([e093f34](https://github.com/rogerpadilla/uql/commit/e093f343bc9635b861c3674c6a9633b880adabef))
 
 
 
@@ -20,6 +20,20 @@ All notable changes to this project will be documented in this file. Please add
 
 date format is [yyyy-mm-dd]
 
+## [0.3.2] - 2026-03-12
+### Improvements
+- **Upsert `created` Flag**: added `created?: boolean` to `QueryUpdateResult` — `true` when the record was inserted, `false` when updated. Supported on PostgreSQL, MySQL, and MongoDB. Returns `undefined` on SQLite and MariaDB where the driver cannot determine this.
+
+### Bug Fixes
+- **MongoDB `upsertOne`**: Fixed `firstId` always being `undefined` on insert by switching from `returnDocument: 'before'` to `returnDocument: 'after'`.
+
+### Test Coverage
+- Added dialect-specific `shouldUpsertOne` overrides for all 5 dialects asserting `created` and `firstId` behavior.
+
+## [0.3.1] - 2026-03-12
+### New Features
+- **MongoDB Atlas Vector Search**: Semantic search now supports MongoDB via the [`$vectorSearch`](https://www.mongodb.com/docs/atlas/atlas-vector-search/vector-search-stage/) aggregation pipeline stage. Same `$sort` API — UQL internally translates to Atlas's native vector search with optimal pre-filtering (`$where` → `$vectorSearch.filter`), score projection via `$meta: 'vectorSearchScore'`, and secondary sort support. Configure with `@Index(['embedding'], { type: 'vectorSearch', name: 'my_index' })`.
+
 ## [0.3.0] - 2026-03-12
 ### New Features
 - **Semantic Search**: First-class vector similarity search across PostgreSQL (pgvector), MariaDB, and SQLite. Query via `$sort` on vector fields:

package/README.md

@@ -31,7 +31,7 @@ const users = await querier.findMany(User, {
 | **[Declarative Transactions](https://uql-orm.dev/querying/transactions)**  | Standard `@Transactional()` and `@InjectQuerier()` decorators for NestJS/DI.                                                |
 | **[Lifecycle Hooks](https://uql-orm.dev/entities/lifecycle-hooks)**| `@BeforeInsert`, `@AfterLoad` and 5 more decorators for validation, timestamps, and computed fields.                        |
 | **[Aggregate Queries](https://uql-orm.dev/querying/aggregate)** | `GROUP BY`, `HAVING`, `COUNT`, `SUM`, `AVG`, `MIN`, `MAX`, and `DISTINCT` across all dialects. |
-| **[Semantic Search](https://uql-orm.dev/querying/semantic-search)** | Vector similarity via `$sort` with `$vector`/`$distance`. Supports `vector`, `halfvec`, `sparsevec` types, HNSW/IVFFlat indexes, and 5 distance metrics across Postgres, MariaDB, and SQLite. |
+| **[Semantic Search](https://uql-orm.dev/querying/semantic-search)** | Vector similarity via `$sort` with `$vector`/`$distance`. Supports `vector`, `halfvec`, `sparsevec` types, HNSW/IVFFlat indexes, and 5 distance metrics across Postgres, MariaDB, SQLite, and MongoDB Atlas. |
 | **[Modern & Versatile](https://uql-orm.dev/entities/virtual-fields)** | **Pure ESM**, high-res timing, [Soft-delete](https://uql-orm.dev/entities/soft-delete), and **JSONB/JSON** support. |
 | **[Database Migrations](https://www.uql-orm.dev/migrations)**          | Built-in [Entity-First synchronization](https://uql-orm.dev/migrations#3-entity-first-synchronization-development) and a robust CLI for version-controlled schema evolution. |
 | **[Logging & Monitoring](https://www.uql-orm.dev/logging)**               | Professional-grade monitoring with slow-query detection and colored output.                                                     |