@hemia/db-connector 0.0.7 → 0.0.9

package/README.md

@@ -17,9 +17,11 @@ npm install @hemia/db-connector
 ### 🗄️ SQL (OLTP - Online Transaction Processing)
 Bases de datos relacionales optimizadas para transacciones y operaciones CRUD.
 
-* ✅ **MySQL** - Base de datos relacional de código abierto
+* ✅ **MySQL** - Base de datos relacional de código abierto (Sequelize)
 * ✅ **PostgreSQL** - Base de datos relacional avanzada con soporte JSON
-* ✅ **Microsoft SQL Server (MSSQL)** - Base de datos empresarial de Microsoft
+  - **Sequelize** - ORM tradicional
+  - **Drizzle ORM** - ORM moderno con TypeScript nativo y máximo rendimiento
+* ✅ **Microsoft SQL Server (MSSQL)** - Base de datos empresarial de Microsoft (Sequelize)
 
 **Casos de uso:**
 - Sistemas transaccionales (e-commerce, banking)
@@ -102,6 +104,96 @@ await sql.withTransaction(async (transaction) => {
 });
 ```
 
+### PostgreSQL con Drizzle ORM (Recomendado)
+
+```ts
+import { 
+  DrizzlePostgresConnector,
+  pgTable, 
+  serial, 
+  varchar, 
+  integer,
+  eq, 
+  and, 
+  gt 
+} from '@hemia/db-connector';
+
+// 1. Definir schema con tipos
+const users = pgTable('users', {
+  id: serial('id').primaryKey(),
+  name: varchar('name', { length: 255 }).notNull(),
+  email: varchar('email', { length: 255 }).notNull().unique(),
+  age: integer('age')
+});
+
+// 2. Conectar y registrar schema
+const connector = new DrizzlePostgresConnector({
+  host: 'localhost',
+  port: 5432,
+  database: 'mydb',
+  user: 'postgres',
+  password: 'password',
+  dialect: 'postgresql'
+});
+
+await connector.connect();
+connector.registerTableSchema('users', users);
+
+// 3. Usar API nativa de Drizzle (tipado completo)
+const db = connector.getDb();
+
+// SELECT con tipos inferidos
+const activeAdults = await db
+  .select()
+  .from(users)
+  .where(and(
+    eq(users.status, 'active'),
+    gt(users.age, 18)
+  ));
+
+// INSERT con autocompletado
+const newUser = await db
+  .insert(users)
+  .values({
+    name: 'John Doe',
+    email: 'john@example.com',
+    age: 30
+  })
+  .returning();
+
+// UPDATE
+await db
+  .update(users)
+  .set({ name: 'Jane Doe' })
+  .where(eq(users.id, 1));
+
+// O usar API abstracta (compatible con Sequelize)
+const users = await connector.select('users', {
+  where: { age: { $gt: 18 } },
+  limit: 10
+});
+```
+
+**Operadores soportados:**
+- `eq(column, value)` - Igual a
+- `ne(column, value)` - No igual a
+- `gt(column, value)` - Mayor que / `gte` - Mayor o igual
+- `lt(column, value)` - Menor que / `lte` - Menor o igual  
+- `like(column, pattern)` - LIKE / `ilike` - ILIKE (case-insensitive)
+- `inArray(column, values)` - IN (lista)
+- `isNull(column)` - IS NULL
+- `and(...conditions)` - AND lógico / `or` - OR lógico
+- `not(condition)` - NOT lógico
+
+**Ventajas de Drizzle sobre Sequelize:**
+- ⚡ **3-4x más rápido** en queries complejas
+- 🎯 **Type-safety 100%** sin decoradores ni boilerplate
+- 📦 **Bundle 50% más pequeño** que Sequelize
+- 🔧 **Migrations automáticas** con Drizzle Kit
+- 🚀 **Zero overhead** - todo compile-time
+
+> 📖 **Nota técnica**: DrizzlePostgresConnector usa una arquitectura independiente (`DrizzleSqlConnector`) sin dependencias de Sequelize. Ver [DRIZZLE_REFACTOR.md](./DRIZZLE_REFACTOR.md) para detalles de implementación.
+
 ### ClickHouse (OLAP)
 
 ```ts