zormz 1.5.0 → 1.6.1

package/README.md

@@ -364,7 +364,212 @@ MENOR('edad', 18)
 ```
 ---
 
-## Ejemplo de Uso
+---
+
+## Complementos de Select (Funciones agregadas SQL)
+
+Este módulo proporciona **funciones auxiliares** para facilitar el uso de funciones agregadas SQL dentro de tu sistema de consultas usando `DB.Select()`.
+
+Actualmente incluye soporte para:
+
+* AVG
+* COUNT
+* MIN
+* MAX
+
+Estas funciones permiten generar expresiones SQL limpias, reutilizables y tipadas desde TypeScript.
+
+---
+
+---
+
+# Uso general
+
+Todas las funciones reciben:
+
+```ts
+(nombreColumna, aliasOpcional)
+```
+
+Donde:
+
+| Parámetro | Tipo              | Descripción                        |
+| --------- | ----------------- | ---------------------------------- |
+| columna   | string            | Nombre de la columna de la tabla   |
+| alias     | string (opcional) | Nombre personalizado del resultado |
+
+Retornan:
+
+```ts
+string
+```
+
+Lista para ser usada dentro de `DB.Select()`.
+
+---
+
+# Funciones disponibles
+
+## AVG()
+
+Calcula el promedio de una columna.
+
+```ts
+const [resultado] = await DB.Select([
+  AVG(usuarios.iduser, "promedio")
+])
+.from(usuarios())
+.execute();
+```
+
+Resultado:
+
+```ts
+{ promedio: '4.0000000000000000' }
+```
+
+---
+
+## COUNT()
+
+Cuenta la cantidad de registros.
+
+```ts
+const datos = await DB.Select([
+  COUNT(usuarios.iduser, "cantidad")
+])
+.from(usuarios())
+.execute();
+```
+
+Resultado:
+
+```ts
+[ { cantidad: 9 } ]
+```
+
+---
+
+## MIN()
+
+Obtiene el valor mínimo de una columna.
+
+```ts
+const datos = await DB.Select([
+  MIN(usuarios.iduser, "minimo")
+])
+.from(usuarios())
+.execute();
+```
+
+Resultado:
+
+```ts
+[ { minimo: 1 } ]
+```
+
+---
+
+## MAX()
+
+Obtiene el valor máximo de una columna.
+
+```ts
+const [datos] = await DB.Select([
+  MAX(usuarios.iduser, "maximo")
+])
+.from(usuarios())
+.execute();
+```
+
+Resultado:
+
+```ts
+{ maximo: 7 }
+```
+
+---
+
+# Alias (pseudoNombre)
+
+El segundo parámetro permite definir el nombre del campo retornado:
+
+```ts
+AVG("usuarios.edad", "edad_promedio")
+```
+
+Genera internamente:
+
+```sql
+AVG(usuarios.edad) AS edad_promedio
+```
+
+Si no se especifica alias:
+
+```ts
+AVG("usuarios.edad")
+```
+
+Genera:
+
+```sql
+AVG(usuarios.edad)
+```
+
+---
+
+# Ejemplo completo
+
+```ts
+const resultado = await DB.Select([
+  COUNT(usuarios.iduser, "total"),
+  MAX(usuarios.iduser, "mayor"),
+  MIN(usuarios.iduser, "menor"),
+  AVG(usuarios.iduser, "promedio")
+])
+.from(usuarios())
+.execute();
+```
+
+Resultado:
+
+```ts
+[
+  {
+    total: 9,
+    mayor: 7,
+    menor: 1,
+    promedio: "4.0000000000000000"
+  }
+]
+```
+
+---
+
+# Objetivo del módulo
+
+Este módulo existe para:
+
+* Evitar escribir SQL manual repetitivo
+* Mejorar legibilidad del código
+* Mantener consistencia en alias
+* Facilitar composición de consultas dinámicas
+* Integrarse naturalmente con `DB.Select()` 
+
+---
+
+# Próximas mejoras sugeridas
+
+Puedes ampliar fácilmente el módulo agregando:
+
+* SUM()
+* ROUND()
+
+Siguiendo exactamente el mismo patrón usado aquí.
+
+---
+
+## Ejemplo de Uso ZORMZ
 
 ```ts
 import {
@@ -429,9 +634,8 @@ pruebaData().catch(console.error);
 - ORM en version inicial con enfoque de tipado y autompletado
 - Compatible con **MYSQL** y **PG**
 - Preparado para extenderse
-- Las versiones +1.3.0 son mas estables , las anteriores estaban en desarrollo y presentan multiples errores
-- version estable 1.4.6
-- Se corrigio la compatiblidad de PG al momento de realizar Insert :c losiento
+- Las versiones +1.5.0 son mas estables , las anteriores estaban en desarrollo y presentan multiples errores
+- version estable 1.5.0
 
 ## Licencia
 

package/dist/index.d.mts

@@ -1,3 +1,23 @@
+interface ResultSetHeaderMysql {
+  fieldCount: number;
+  affectedRows: number;
+  insertId: number;
+  info: string;
+  serverStatus: number;
+  warningStatus: number;
+  changedRows: number;
+}
+
+interface ResultPG {
+  ok: boolean;
+  command?: "SELECT" | "INSERT" | "UPDATE" | "DELETE" | "DDL" | "DROP";
+  rowCount: number | null;
+  oid?: number | null;
+  rows?: any[];
+  fields?: any[];
+  rowAsArray?: boolean;
+}
+
 type ColumnTypes =
   | "varchar"
   | "int"
@@ -36,6 +56,13 @@ interface UpdateParams {
   campoUp: string;
   newCampoUp: string;
   dataTable?: boolean;
+}
+
+
+interface roundInd {
+  columna: string;
+  decimales: number;
+  pseudonombre?: string;
 }
 
 interface connecionLocal {
@@ -62,7 +89,7 @@ declare class BDconnection {
     constructor(bd: connectionDB, datos: connecionLocal | connecionRed);
     private conexionMysql;
     private connectionPG;
-    executeConsulta({ query, valores, mensaje, alertar, }: Consultas): Promise<any>;
+    executeConsulta({ query, valores, mensaje, alertar, }: Consultas): Promise<ResultPG | ResultSetHeaderMysql | any>;
 }
 declare function getTipoConexion(): connectionDB;
 /**
@@ -140,7 +167,7 @@ declare class QueryBuilder {
      *
      * @param {arrayData | arrayDatas} values
      * @example
-     * //para un salo dato
+     * //para un solo dato
      * ['dato1','dato2']
      * //para varios datos
      * [['dato1','dato1/2'],['dato2','dato2/2']]
@@ -167,6 +194,7 @@ declare class Select {
     private limit;
     private condicion;
     private orderBy;
+    private offset;
     /**
      * @param {string[]} parametros - campo obligatorio
      * @param {string} tabla - nombre de la ta tabla - campo obligatorio
@@ -202,6 +230,14 @@ declare class Select {
      * @param {Number} cantidad
      */
     LIMIT(cantidad?: number): this;
+    /**
+     *
+     * @param {number} cant
+     * @returns
+     * @example
+     * .LIMIT(10).OFFSET(10).execute()
+     */
+    OFFSET(cant: number): this;
     /**
      *
      * @param {String} texto
@@ -209,7 +245,7 @@ declare class Select {
     /**
      * @returns {Promise<Array<Object>>}
      */
-    execute(see?: boolean): Promise<any[] | undefined>;
+    execute(see?: boolean): Promise<any[]>;
 }
 
 type Valores = Record<string, string | number | undefined>;
@@ -268,7 +304,7 @@ declare class DB {
     static Delete(nombreTabla: string): DeleteR;
 }
 
-type Valor = string | number | boolean;
+type Valor = string | number | boolean | null;
 /**
  *
  * @param {(string | number | boolean )} valor1 - eq(val,val1)
@@ -277,18 +313,18 @@ type Valor = string | number | boolean;
  * //para varios condiciones
  * AND(eq(),eq(),eq(),eq(),OR())
  */
-declare const AND: (...valor1: Valor[]) => string;
-declare function ANDD(valores: string[]): string;
+declare const AND: (...valor1: (string | null)[]) => string;
+declare function ANDD(valores: (string | null)[]): string;
 /**
  *
- * @param {(string | number | boolean )} valor1 - eq(val,val1)
+ * @param {string} valor1 - eq(val,val1)
  * @example
  * //para una sola condicion
  * OR(eq())
  * //para varios condiciones
  * OR(eq(),eq(),eq(),eq(),AND())
  */
-declare const OR: (...valor1: Valor[]) => string;
+declare const OR: (...valor1: (string | null)[]) => string;
 /**
  *
  * @param {string} valores
@@ -296,7 +332,7 @@ declare const OR: (...valor1: Valor[]) => string;
  * @example
  * ORD([eq(),eq()])
  */
-declare const ORD: (valores: string[]) => string;
+declare const ORD: (valores: (string | null)[]) => string;
 /**
  *
  * @param {Valor} condicion1
@@ -500,4 +536,81 @@ declare class Money {
 }
 declare function money(presicion?: number, decimales?: number): Money;
 
-export { AND, ANDD, BDconnection, CURRENT_TIMESTAMP, type Consultas, DB, DeleteR, ILIKE, MAYOR, MENOR, NOTNULL, NOW, NULL, OR, ORD, ORQ, ORQD, QueryBuilder, Select, type TableProxy, type Tipos, UP, Update, type Valores, type arrayData, type arrayDatas, bool, type connecionLocal, type connecionRed, type connectionDB, defineTable, dropTable, eq, generateTable, getConexion, getRed, getTipoConexion, int, money, neq, timestamp, type valor, varchar };
+/**
+ *
+ * @param {string} columna - campo de la tabla
+ * @param {string | undefined} pseudoNombre - nombre columna
+ * @return {string}
+ * @example
+ *
+ * const [promedio] = await DB.Select([AVG(usuarios.iduser, "promedio")])
+     .from(usuarios())
+     .execute();
+ *  =>{ promedio: '4.0000000000000000' }
+ */
+declare const AVG: (columna: string, pseudoNombre?: string) => string;
+/**
+ *
+ * @param {string} columna
+ * @param {string} pseudonombre
+ * @returns {string}
+ * @example
+ *
+ * COUNT(usuarios.iduser,"primero")
+ * //uso
+ * await DB.Select([COUNT(usuarios.iduser,"cantidad")]).from(usuarios()).execute();
+ * => [ { cantidad: 9 } ]
+ */
+declare const COUNT: (columna: string, pseudonombre?: string) => string;
+/**
+ *
+ * @param {string} columna
+ * @param {string} pseudonombre
+ * @returns {string}
+ * @example
+ *
+ * MIN(usuarios.iduser,"primero")
+ * //uso
+ * await DB.Select([MIN(usuarios.iduser,"minimo")]).from(usuarios()).execute();
+ * => [ { minimo: 1 } ]
+ */
+declare const MIN: (columna: string, pseudonombre?: string) => string;
+/**
+ *
+ * @param {string} columna
+ * @param {string} pseudonombre
+ * @returns {string}
+ * @example
+ *
+ * MAX(usuarios.iduser,"primero")
+ * //uso
+ * const [datos2] =  await DB.Select([MAX(usuarios.iduser,"maximo")]).from(usuarios()).execute();
+ * => { maximo: 7 }
+ */
+declare const MAX: (columna: string, pseudonombre?: string) => string;
+/**
+ *
+ * @param {string} columna
+ * @param {string} pseudonombre
+ * @returns {string}
+ * @example
+ *
+ * SUM(usuarios.iduser,"primero")
+ * //uso
+ * const [datos2] =  await DB.Select([SUM(usuarios.iduser,"suma")]).from(usuarios()).execute();
+ * => { suma: 12 }
+ */
+declare const SUM: (columna: string, pseudonombre?: string) => string;
+/**
+ *
+ * @param {roundInd} param
+ * @returns
+ *  *
+ * ROUND(usuarios.dinero,2,"precioAlterado")
+ * //uso
+ * const [datos2] =  await DB.Select([(usuarios.dinero,"precioalterado")]).from(usuarios()).execute();
+ * => { precioalterado: 12.22}
+ */
+declare const ROUND: ({ columna, decimales, pseudonombre }: roundInd) => string;
+
+export { AND, ANDD, AVG, BDconnection, COUNT, CURRENT_TIMESTAMP, type Consultas, DB, DeleteR, ILIKE, MAX, MAYOR, MENOR, MIN, NOTNULL, NOW, NULL, OR, ORD, ORQ, ORQD, QueryBuilder, ROUND, SUM, Select, type TableProxy, type Tipos, UP, Update, type Valores, type arrayData, type arrayDatas, bool, type connecionLocal, type connecionRed, type connectionDB, defineTable, dropTable, eq, generateTable, getConexion, getRed, getTipoConexion, int, money, neq, timestamp, type valor, varchar };

package/dist/index.d.ts

@@ -1,3 +1,23 @@
+interface ResultSetHeaderMysql {
+  fieldCount: number;
+  affectedRows: number;
+  insertId: number;
+  info: string;
+  serverStatus: number;
+  warningStatus: number;
+  changedRows: number;
+}
+
+interface ResultPG {
+  ok: boolean;
+  command?: "SELECT" | "INSERT" | "UPDATE" | "DELETE" | "DDL" | "DROP";
+  rowCount: number | null;
+  oid?: number | null;
+  rows?: any[];
+  fields?: any[];
+  rowAsArray?: boolean;
+}
+
 type ColumnTypes =
   | "varchar"
   | "int"
@@ -36,6 +56,13 @@ interface UpdateParams {
   campoUp: string;
   newCampoUp: string;
   dataTable?: boolean;
+}
+
+
+interface roundInd {
+  columna: string;
+  decimales: number;
+  pseudonombre?: string;
 }
 
 interface connecionLocal {
@@ -62,7 +89,7 @@ declare class BDconnection {
     constructor(bd: connectionDB, datos: connecionLocal | connecionRed);
     private conexionMysql;
     private connectionPG;
-    executeConsulta({ query, valores, mensaje, alertar, }: Consultas): Promise<any>;
+    executeConsulta({ query, valores, mensaje, alertar, }: Consultas): Promise<ResultPG | ResultSetHeaderMysql | any>;
 }
 declare function getTipoConexion(): connectionDB;
 /**
@@ -140,7 +167,7 @@ declare class QueryBuilder {
      *
      * @param {arrayData | arrayDatas} values
      * @example
-     * //para un salo dato
+     * //para un solo dato
      * ['dato1','dato2']
      * //para varios datos
      * [['dato1','dato1/2'],['dato2','dato2/2']]
@@ -167,6 +194,7 @@ declare class Select {
     private limit;
     private condicion;
     private orderBy;
+    private offset;
     /**
      * @param {string[]} parametros - campo obligatorio
      * @param {string} tabla - nombre de la ta tabla - campo obligatorio
@@ -202,6 +230,14 @@ declare class Select {
      * @param {Number} cantidad
      */
     LIMIT(cantidad?: number): this;
+    /**
+     *
+     * @param {number} cant
+     * @returns
+     * @example
+     * .LIMIT(10).OFFSET(10).execute()
+     */
+    OFFSET(cant: number): this;
     /**
      *
      * @param {String} texto
@@ -209,7 +245,7 @@ declare class Select {
     /**
      * @returns {Promise<Array<Object>>}
      */
-    execute(see?: boolean): Promise<any[] | undefined>;
+    execute(see?: boolean): Promise<any[]>;
 }
 
 type Valores = Record<string, string | number | undefined>;
@@ -268,7 +304,7 @@ declare class DB {
     static Delete(nombreTabla: string): DeleteR;
 }
 
-type Valor = string | number | boolean;
+type Valor = string | number | boolean | null;
 /**
  *
  * @param {(string | number | boolean )} valor1 - eq(val,val1)
@@ -277,18 +313,18 @@ type Valor = string | number | boolean;
  * //para varios condiciones
  * AND(eq(),eq(),eq(),eq(),OR())
  */
-declare const AND: (...valor1: Valor[]) => string;
-declare function ANDD(valores: string[]): string;
+declare const AND: (...valor1: (string | null)[]) => string;
+declare function ANDD(valores: (string | null)[]): string;
 /**
  *
- * @param {(string | number | boolean )} valor1 - eq(val,val1)
+ * @param {string} valor1 - eq(val,val1)
  * @example
  * //para una sola condicion
  * OR(eq())
  * //para varios condiciones
  * OR(eq(),eq(),eq(),eq(),AND())
  */
-declare const OR: (...valor1: Valor[]) => string;
+declare const OR: (...valor1: (string | null)[]) => string;
 /**
  *
  * @param {string} valores
@@ -296,7 +332,7 @@ declare const OR: (...valor1: Valor[]) => string;
  * @example
  * ORD([eq(),eq()])
  */
-declare const ORD: (valores: string[]) => string;
+declare const ORD: (valores: (string | null)[]) => string;
 /**
  *
  * @param {Valor} condicion1
@@ -500,4 +536,81 @@ declare class Money {
 }
 declare function money(presicion?: number, decimales?: number): Money;
 
-export { AND, ANDD, BDconnection, CURRENT_TIMESTAMP, type Consultas, DB, DeleteR, ILIKE, MAYOR, MENOR, NOTNULL, NOW, NULL, OR, ORD, ORQ, ORQD, QueryBuilder, Select, type TableProxy, type Tipos, UP, Update, type Valores, type arrayData, type arrayDatas, bool, type connecionLocal, type connecionRed, type connectionDB, defineTable, dropTable, eq, generateTable, getConexion, getRed, getTipoConexion, int, money, neq, timestamp, type valor, varchar };
+/**
+ *
+ * @param {string} columna - campo de la tabla
+ * @param {string | undefined} pseudoNombre - nombre columna
+ * @return {string}
+ * @example
+ *
+ * const [promedio] = await DB.Select([AVG(usuarios.iduser, "promedio")])
+     .from(usuarios())
+     .execute();
+ *  =>{ promedio: '4.0000000000000000' }
+ */
+declare const AVG: (columna: string, pseudoNombre?: string) => string;
+/**
+ *
+ * @param {string} columna
+ * @param {string} pseudonombre
+ * @returns {string}
+ * @example
+ *
+ * COUNT(usuarios.iduser,"primero")
+ * //uso
+ * await DB.Select([COUNT(usuarios.iduser,"cantidad")]).from(usuarios()).execute();
+ * => [ { cantidad: 9 } ]
+ */
+declare const COUNT: (columna: string, pseudonombre?: string) => string;
+/**
+ *
+ * @param {string} columna
+ * @param {string} pseudonombre
+ * @returns {string}
+ * @example
+ *
+ * MIN(usuarios.iduser,"primero")
+ * //uso
+ * await DB.Select([MIN(usuarios.iduser,"minimo")]).from(usuarios()).execute();
+ * => [ { minimo: 1 } ]
+ */
+declare const MIN: (columna: string, pseudonombre?: string) => string;
+/**
+ *
+ * @param {string} columna
+ * @param {string} pseudonombre
+ * @returns {string}
+ * @example
+ *
+ * MAX(usuarios.iduser,"primero")
+ * //uso
+ * const [datos2] =  await DB.Select([MAX(usuarios.iduser,"maximo")]).from(usuarios()).execute();
+ * => { maximo: 7 }
+ */
+declare const MAX: (columna: string, pseudonombre?: string) => string;
+/**
+ *
+ * @param {string} columna
+ * @param {string} pseudonombre
+ * @returns {string}
+ * @example
+ *
+ * SUM(usuarios.iduser,"primero")
+ * //uso
+ * const [datos2] =  await DB.Select([SUM(usuarios.iduser,"suma")]).from(usuarios()).execute();
+ * => { suma: 12 }
+ */
+declare const SUM: (columna: string, pseudonombre?: string) => string;
+/**
+ *
+ * @param {roundInd} param
+ * @returns
+ *  *
+ * ROUND(usuarios.dinero,2,"precioAlterado")
+ * //uso
+ * const [datos2] =  await DB.Select([(usuarios.dinero,"precioalterado")]).from(usuarios()).execute();
+ * => { precioalterado: 12.22}
+ */
+declare const ROUND: ({ columna, decimales, pseudonombre }: roundInd) => string;
+
+export { AND, ANDD, AVG, BDconnection, COUNT, CURRENT_TIMESTAMP, type Consultas, DB, DeleteR, ILIKE, MAX, MAYOR, MENOR, MIN, NOTNULL, NOW, NULL, OR, ORD, ORQ, ORQD, QueryBuilder, ROUND, SUM, Select, type TableProxy, type Tipos, UP, Update, type Valores, type arrayData, type arrayDatas, bool, type connecionLocal, type connecionRed, type connectionDB, defineTable, dropTable, eq, generateTable, getConexion, getRed, getTipoConexion, int, money, neq, timestamp, type valor, varchar };