@uql/core 3.3.0 → 3.4.2

package/CHANGELOG.md

@@ -3,7 +3,7 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-# [3.3.0](https://github.com/rogerpadilla/uql/compare/@uql/core@3.2.0...@uql/core@3.3.0) (2025-12-30)
+## [3.4.2](https://github.com/rogerpadilla/uql/compare/@uql/core@3.4.1...@uql/core@3.4.2) (2025-12-31)
 
 **Note:** Version bump only for package @uql/core
 

package/README.md

@@ -2,13 +2,12 @@
 
 [![uql maku](assets/logo.svg)](https://uql.app)
 
-[![tests](https://github.com/rogerpadilla/uql/actions/workflows/tests.yml/badge.svg)](https://github.com/rogerpadilla/uql) [![coverage status](https://coveralls.io/repos/rogerpadilla/uql/badge.svg?branch=main)](https://coveralls.io/r/rogerpadilla/uql?branch=main) [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/rogerpadilla/uql/blob/main/LICENSE) [![npm version](https://img.shields.io/npm/v/@uql/core.svg)](https://www.npmjs.com/package/@uql/core)
+[![tests](https://github.com/rogerpadilla/uql/actions/workflows/tests.yml/badge.svg)](https://github.com/rogerpadilla/uql) [![Coverage Status](https://coveralls.io/repos/github/rogerpadilla/uql/badge.svg?branch=main)](https://coveralls.io/github/rogerpadilla/uql?branch=main) [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/rogerpadilla/uql/blob/main/LICENSE) [![npm version](https://img.shields.io/npm/v/@uql/core.svg)](https://www.npmjs.com/package/@uql/core)
 
-[UQL](https://uql.app) is the [smartest ORM](https://medium.com/@rogerpadillac/in-search-of-the-perfect-orm-e01fcc9bce3d) for TypeScript, it is designed to be fast, safe, and easy to integrate into any application.
+**[UQL](https://uql.app)** is the [smartest ORM](https://medium.com/@rogerpadillac/in-search-of-the-perfect-orm-e01fcc9bce3d) for TypeScript. It is engineered to be **fast**, **safe**, and **universally compatible**.
 
-It can run in Node.js, Browser, React Native, Expo, Electron, Deno, Bun, and many more!
-
-Uses a consistent API for distinct databases, including PostgreSQL, MySQL, MariaDB, and SQLite (inspired by MongoDB glorious syntax).
+- **Runs Everywhere**: Node.js, Bun, Deno, Cloudflare Workers, Electron, React Native, and even the Browser.
+- **Unified API**: A consistent, expressive query interface for PostgreSQL, MySQL, MariaDB, SQLite, LibSQL, Neon, Cloudflare D1, and MongoDB (inspired by its glorious syntax).
 
  
 
@@ -33,7 +32,7 @@ See [this article](https://medium.com/@rogerpadillac/in-search-of-the-perfect-or
 
 - **Type-safe and Context-aware queries**: Squeeze the power of `TypeScript` for auto-completion and validation of operators at any depth, [including relations and their fields](https://www.uql.app/docs/querying-relations).
 - **Context-Object SQL Generation**: Uses a sophisticated `QueryContext` pattern to ensure perfectly indexed placeholders ($1, $2, etc.) and robust SQL fragment management, even in the most complex sub-queries.
-- **Unified API across Databases**: Write once, run anywhere. Seamlessly switch between `PostgreSQL`, `MySQL`, `MariaDB`, `SQLite`, and even `MongoDB`.
+- **Unified API across Databases**: Write once, run anywhere. Seamlessly switch between `PostgreSQL`, `MySQL`, `MariaDB`, `SQLite`, `LibSQL`, `Neon`, `Cloudflare D1`, and even `MongoDB`.
 - **Serializable JSON Syntax**: Queries can be expressed as `100%` valid `JSON`, allowing them to be easily transported from frontend to backend.
 - **Naming Strategies**: Effortlessly translate between TypeScript `CamelCase` and database `snake_case` (or any custom format) with a pluggable system.
 - **Built-in Serialization**: A centralized task queue and `@Serialized()` decorator ensure database operations are thread-safe and race-condition free by default.
@@ -56,12 +55,15 @@ See [this article](https://medium.com/@rogerpadillac/in-search-of-the-perfect-or
 
 2. Install one of the specific adapters for your database:
 
-| Database     | Driver
-| ------------ | ----------------
-| `PostgreSQL` | `pg`
-| `SQLite`     | `better-sqlite3`
-| `MariaDB`    | `mariadb`
-| `MySQL`      | `mysql2`
+| Database | Driver
+| :--- | :---
+| `PostgreSQL` (incl. CockroachDB, YugabyteDB) | `pg`
+| `MySQL` (incl. TiDB, Aurora) | `mysql2`
+| `MariaDB` | `mariadb`
+| `SQLite` | `better-sqlite3`
+| `Cloudflare D1` | `Native Binding`
+| `LibSQL` (Turso) | `@libsql/client`
+| `Neon` (Serverless Postgres) | `@neondatabase/serverless`
 
  
 
@@ -203,14 +205,9 @@ export const pool = new PgQuerierPool(
 
 ## 4. Manipulate the data
 
-UQL provides multiple ways to interact with your data, from low-level `Queriers` to high-level `Repositories`.
-
-### Using Repositories (Recommended)
-
-Repositories provide a clean, Data-Mapper style interface for your entities.
+UQL provides multiple ways to interact with your data, from generic `Queriers` (that works with any entity) to entity-specific `Repositories`.
 
 ```ts
-import { GenericRepository } from '@uql/core';
 import { User } from './shared/models/index.js';
 import { pool } from './shared/orm.js';
 
@@ -218,10 +215,8 @@ import { pool } from './shared/orm.js';
 const querier = await pool.getQuerier();
 
 try {
-  const userRepository = new GenericRepository(User, querier);
-
   // Advanced querying with relations and virtual fields
-  const users = await userRepository.findMany({
+  const users = await querier.findMany(User, {
     $select: {
       id: true,
       name: true,
@@ -246,14 +241,13 @@ try {
 UQL's query syntax is context-aware. When you query a relation, the available fields and operators are automatically suggested and validated based on that related entity.
 
 ```ts
-import { GenericRepository } from '@uql/core';
 import { pool } from './shared/orm.js';
 import { User } from './shared/models/index.js';
 
-const authorsWithPopularPosts = await pool.transaction(async (querier) => {
-  const userRepository = new GenericRepository(User, querier);
+const querier = await pool.getQuerier();
 
-  return userRepository.findMany({
+try {
+  const authorsWithPopularPosts = await querier.findMany(User, {
     $select: {
       id: true,
       name: true,
@@ -275,7 +269,9 @@ const authorsWithPopularPosts = await pool.transaction(async (querier) => {
       name: { $istartsWith: 'a' }
     }
   });
-});
+} finally {
+  await querier.release();
+}
 ```
 
 ### Advanced: Virtual Fields & Raw SQL