@uql/core 3.1.4 → 3.3.0

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.1.4](https://github.com/rogerpadilla/uql/compare/@uql/core@3.1.3...@uql/core@3.1.4) (2025-12-30)
+# [3.3.0](https://github.com/rogerpadilla/uql/compare/@uql/core@3.2.0...@uql/core@3.3.0) (2025-12-30)
 
 **Note:** Version bump only for package @uql/core
 
@@ -192,7 +192,7 @@ Reflect major changes in the package structure and dependencies.
 - Update dependencies.
 
   ```ts
-  const ids = await querierPool.transaction(async (querier) => {
+  const ids = await pool.transaction(async (querier) => {
     const data = await querier.findMany(...);
     const ids = await querier.insertMany(...);
     return ids;

package/README.md

@@ -92,11 +92,12 @@ bun add pg
 Annotate your classes with decorators from `@uql/core`. UQL supports detailed schema metadata for precise DDL generation.
 
 ```ts
+import { v7 as uuidv7 } from 'uuid';
 import { Entity, Id, Field, OneToOne, OneToMany, ManyToOne, ManyToMany, type Relation } from '@uql/core';
 
 @Entity()
 export class User {
-  @Id()
+  @Id({ onInsert: () => uuidv7() })
   id?: string;
 
   @Field({ length: 100, index: true })
@@ -114,7 +115,7 @@ export class User {
 
 @Entity()
 export class Profile {
-  @Id()
+  @Id({ onInsert: () => uuidv7() })
   id?: string;
 
   @Field()
@@ -147,7 +148,7 @@ export class Post {
 
 @Entity()
 export class Tag {
-  @Id()
+  @Id({ onInsert: () => uuidv7() })
   id?: string;
 
   @Field()
@@ -156,7 +157,7 @@ export class Tag {
 
 @Entity()
 export class PostTag {
-  @Id()
+  @Id({ onInsert: () => uuidv7() })
   id?: string;
 
   @Field({ reference: () => Post })
@@ -178,7 +179,7 @@ A querier-pool can be set in any of the bootstrap files of your app (e.g. in the
 import { SnakeCaseNamingStrategy } from '@uql/core';
 import { PgQuerierPool } from '@uql/core/postgres';
 
-export const querierPool = new PgQuerierPool(
+export const pool = new PgQuerierPool(
   {
     host: 'localhost',
     user: 'theUser',
@@ -211,10 +212,10 @@ Repositories provide a clean, Data-Mapper style interface for your entities.
 ```ts
 import { GenericRepository } from '@uql/core';
 import { User } from './shared/models/index.js';
-import { querierPool } from './shared/orm.js';
+import { pool } from './shared/orm.js';
 
 // Get a querier from the pool
-const querier = await querierPool.getQuerier();
+const querier = await pool.getQuerier();
 
 try {
   const userRepository = new GenericRepository(User, querier);
@@ -246,10 +247,10 @@ UQL's query syntax is context-aware. When you query a relation, the available fi
 
 ```ts
 import { GenericRepository } from '@uql/core';
-import { querierPool } from './shared/orm.js';
+import { pool } from './shared/orm.js';
 import { User } from './shared/models/index.js';
 
-const authorsWithPopularPosts = await querierPool.transaction(async (querier) => {
+const authorsWithPopularPosts = await pool.transaction(async (querier) => {
   const userRepository = new GenericRepository(User, querier);
 
   return userRepository.findMany({
@@ -282,6 +283,7 @@ const authorsWithPopularPosts = await querierPool.transaction(async (querier) =>
 Define complex logic directly in your entities using `raw` functions from `uql/util`. These are highly efficient as they are resolved during SQL generation.
 
 ```ts
+import { v7 as uuidv7 } from 'uuid';
 import { Entity, Id, Field, raw } from '@uql/core';
 import { ItemTag } from './shared/models/index.js';
 
@@ -313,10 +315,10 @@ export class Item {
 UQL ensures your operations are serialized and thread-safe.
 
 ```ts
-import { querierPool } from './shared/orm.js';
+import { pool } from './shared/orm.js';
 import { User, Profile } from './shared/models/index.js';
 
-const result = await querierPool.transaction(async (querier) => {
+const result = await pool.transaction(async (querier) => {
   const user = await querier.findOne(User, { $where: { email: '...' } });
   const profileId = await querier.insertOne(Profile, { userId: user.id, ... });
   return { userId: user.id, profileId };
@@ -339,7 +341,7 @@ import { PgQuerierPool } from '@uql/core/postgres';
 import { User, Post } from './shared/models/index.js';
 
 export default {
-  querierPool: new PgQuerierPool({ /* config */ }),
+  pool: new PgQuerierPool({ /* config */ }),
   entities: [User, Post],
   migrationsPath: './migrations',
 };
@@ -377,9 +379,9 @@ In development, you can use `autoSync` to automatically keep your database in sy
 
 ```ts
 import { Migrator } from '@uql/core/migrate';
-import { querierPool } from './shared/orm.js';
+import { pool } from './shared/orm.js';
 
-const migrator = new Migrator(querierPool);
+const migrator = new Migrator(pool);
 await migrator.autoSync({ logging: true });
 ```
 
@@ -406,3 +408,13 @@ For those who want to see the "engine under the hood," check out these resources
   - [PostgreSQL Spec](https://github.com/rogerpadilla/uql/blob/main/packages/core/src/postgres/postgresDialect.spec.ts) | [MySQL Spec](https://github.com/rogerpadilla/uql/blob/main/packages/core/src/mysql/mysqlDialect.spec.ts) | [SQLite Spec](https://github.com/rogerpadilla/uql/blob/main/packages/core/src/sqlite/sqliteDialect.spec.ts).
   - [Querier Integration Tests](https://github.com/rogerpadilla/uql/blob/main/packages/core/src/querier/abstractSqlQuerier-spec.ts): Testing the interaction between SQL generation and connection management.
   - [MongoDB Migration Tests](https://github.com/rogerpadilla/uql/blob/main/packages/core/src/migrate/migrator-mongo.it.ts): Integration tests ensuring correct collection and index synchronization for MongoDB.
+
+---
+
+## Built with ❤️ and supported by
+
+UQL is an open-source project driven by the community and proudly sponsored by **[Variability.ai](https://variability.ai)**.
+
+> "Intelligence in Every Fluctuation"
+
+Their support helps us maintain and evolve the "Smartest ORM" for developers everywhere. Thank you for being part of our journey!

package/dist/browser/uql-browser.min.js

@@ -620,8 +620,8 @@ export { Sqlite3QuerierPool, SqliteDialect, SqliteQuerier };
  * MySQL/MariaDB schema introspector.
  * Works with both MySQL and MariaDB as they share the same information_schema structure.
  */ class MysqlSchemaIntrospector {
-    constructor(querierPool){
-        this.querierPool = querierPool;
+    constructor(pool){
+        this.pool = pool;
     }
     async getTableSchema(tableName) {
         const querier = await this.getQuerier();
@@ -684,7 +684,7 @@ export { Sqlite3QuerierPool, SqliteDialect, SqliteQuerier };
         return (results[0]?.count ?? 0) > 0;
     }
     async getQuerier() {
-        const querier = await this.querierPool.getQuerier();
+        const querier = await this.pool.getQuerier();
         if (!isSqlQuerier(querier)) {
             await querier.release();
             throw new Error('MysqlSchemaIntrospector requires a SQL-based querier');
@@ -842,8 +842,8 @@ export { Sqlite3QuerierPool, SqliteDialect, SqliteQuerier };
 /**
  * PostgreSQL schema introspector
  */ class PostgresSchemaIntrospector {
-    constructor(querierPool){
-        this.querierPool = querierPool;
+    constructor(pool){
+        this.pool = pool;
     }
     async getTableSchema(tableName) {
         const querier = await this.getQuerier();
@@ -907,7 +907,7 @@ export { Sqlite3QuerierPool, SqliteDialect, SqliteQuerier };
         return results[0]?.exists ?? false;
     }
     async getQuerier() {
-        const querier = await this.querierPool.getQuerier();
+        const querier = await this.pool.getQuerier();
         if (!isSqlQuerier(querier)) {
             await querier.release();
             throw new Error('PostgresSchemaIntrospector requires a SQL-based querier');
@@ -1115,8 +1115,8 @@ export { Sqlite3QuerierPool, SqliteDialect, SqliteQuerier };
 /**
  * SQLite schema introspector
  */ class SqliteSchemaIntrospector {
-    constructor(querierPool){
-        this.querierPool = querierPool;
+    constructor(pool){
+        this.pool = pool;
     }
     async getTableSchema(tableName) {
         const querier = await this.getQuerier();
@@ -1179,7 +1179,7 @@ export { Sqlite3QuerierPool, SqliteDialect, SqliteQuerier };
         return (results[0]?.count ?? 0) > 0;
     }
     async getQuerier() {
-        const querier = await this.querierPool.getQuerier();
+        const querier = await this.pool.getQuerier();
         if (!isSqlQuerier(querier)) {
             await querier.release();
             throw new Error('SqliteSchemaIntrospector requires a SQL-based querier');
@@ -1436,11 +1436,11 @@ class MongoSchemaGenerator extends AbstractDialect {
 }
 
 class MongoSchemaIntrospector {
-    constructor(querierPool){
-        this.querierPool = querierPool;
+    constructor(pool){
+        this.pool = pool;
     }
     async getTableSchema(tableName) {
-        const querier = await this.querierPool.getQuerier();
+        const querier = await this.pool.getQuerier();
         try {
             const { db } = querier;
             const collections = await db.listCollections({
@@ -1465,7 +1465,7 @@ class MongoSchemaIntrospector {
         }
     }
     async getTableNames() {
-        const querier = await this.querierPool.getQuerier();
+        const querier = await this.pool.getQuerier();
         try {
             const { db } = querier;
             const collections = await db.listCollections().toArray();
@@ -1484,8 +1484,8 @@ class MongoSchemaIntrospector {
  * Stores migration state in a database table.
  * Uses the querier's dialect for escaping and placeholders.
  */ class DatabaseMigrationStorage {
-    constructor(querierPool, options = {}){
-        this.querierPool = querierPool;
+    constructor(pool, options = {}){
+        this.pool = pool;
         this.storageInitialized = false;
         this.tableName = options.tableName ?? 'uql_migrations';
     }
@@ -1493,7 +1493,7 @@ class MongoSchemaIntrospector {
         if (this.storageInitialized) {
             return;
         }
-        const querier = await this.querierPool.getQuerier();
+        const querier = await this.pool.getQuerier();
         if (!isSqlQuerier(querier)) {
             await querier.release();
             throw new Error('DatabaseMigrationStorage requires a SQL-based querier');
@@ -1517,7 +1517,7 @@ class MongoSchemaIntrospector {
     }
     async executed() {
         await this.ensureStorage();
-        const querier = await this.querierPool.getQuerier();
+        const querier = await this.pool.getQuerier();
         if (!isSqlQuerier(querier)) {
             await querier.release();
             throw new Error('DatabaseMigrationStorage requires a SQL-based querier');
@@ -1556,10 +1556,10 @@ class MongoSchemaIntrospector {
 /**
  * Main class for managing database migrations
  */ class Migrator {
-    constructor(querierPool, options = {}){
-        this.querierPool = querierPool;
-        this.dialect = options.dialect ?? querierPool.dialect ?? 'postgres';
-        this.storage = options.storage ?? new DatabaseMigrationStorage(querierPool, {
+    constructor(pool, options = {}){
+        this.pool = pool;
+        this.dialect = options.dialect ?? pool.dialect ?? 'postgres';
+        this.storage = options.storage ?? new DatabaseMigrationStorage(pool, {
             tableName: options.tableName
         });
         this.migrationsPath = options.migrationsPath ?? './migrations';
@@ -1576,15 +1576,15 @@ class MongoSchemaIntrospector {
     createIntrospector() {
         switch(this.dialect){
             case 'postgres':
-                return new PostgresSchemaIntrospector(this.querierPool);
+                return new PostgresSchemaIntrospector(this.pool);
             case 'mysql':
-                return new MysqlSchemaIntrospector(this.querierPool);
+                return new MysqlSchemaIntrospector(this.pool);
             case 'mariadb':
-                return new MariadbSchemaIntrospector(this.querierPool);
+                return new MariadbSchemaIntrospector(this.pool);
             case 'sqlite':
-                return new SqliteSchemaIntrospector(this.querierPool);
+                return new SqliteSchemaIntrospector(this.pool);
             case 'mongodb':
-                return new MongoSchemaIntrospector(this.querierPool);
+                return new MongoSchemaIntrospector(this.pool);
             default:
                 return undefined;
         }
@@ -1698,7 +1698,7 @@ class MongoSchemaIntrospector {
    * Run a single migration within a transaction
    */ async runMigration(migration, direction) {
         const startTime = Date.now();
-        const querier = await this.querierPool.getQuerier();
+        const querier = await this.pool.getQuerier();
         if (!isSqlQuerier(querier)) {
             await querier.release();
             throw new Error('Migrator requires a SQL-based querier');
@@ -1840,7 +1840,7 @@ class MongoSchemaIntrospector {
             throw new Error('Schema generator not set. Call setSchemaGenerator() first.');
         }
         const entities = this.entities.length > 0 ? this.entities : getEntities();
-        const querier = await this.querierPool.getQuerier();
+        const querier = await this.pool.getQuerier();
         if (!isSqlQuerier(querier)) {
             await querier.release();
             throw new Error('Migrator requires a SQL-based querier');
@@ -1912,7 +1912,7 @@ class MongoSchemaIntrospector {
         return filteredDiff;
     }
     async executeSyncStatements(statements, options) {
-        const querier = await this.querierPool.getQuerier();
+        const querier = await this.pool.getQuerier();
         try {
             if (this.dialect === 'mongodb') {
                 await this.executeMongoSyncStatements(statements, options, querier);