pg-functions 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License Copyright (c) 2025 mauricio.basta
+
+Permission is hereby granted, free
+of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice
+(including the next paragraph) shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,78 @@
+# pg-functions
+
+Abstracción para ejecución de funciones PL/pgSQL desde Node.js con [`pg`](https://www.npmjs.com/package/pg).
+
+## Características
+
+- Ejecución de funciones PL/pgSQL de forma tipada.
+- Transacciones automáticas (`PgFunction`) o manuales (`PgFunctionTransactional`).
+- Tipado con genéricos para resultados (`<T>`).
+- Inyección de opcional de logger (compatible con `pino`, `console`, etc.).
+- Basado en el `Pool` del proyecto consumidor.
+
+
+## Instalación
+
+```bash
+pnpm add pg-functions
+```
+
+## Configuración
+
+``` ts
+import { Pool } from 'pg';
+import { registerPool } from 'pg-functions';
+
+registerPool(new Pool({/* ... */}))
+```
+
+## Uso
+
+### 1. Crear una función PL/pgSQL en base de datos
+```sql
+CREATE OR REPLACE FUNCTION fn_obtener_roles_usuario()
+RETURNS TABLE (id INTEGER, nombre VARCHAR)
+LANGUAGE plpgsql
+AS $$
+BEGIN
+  RETURN QUERY
+  SELECT "ID_ROL_USUARIO" AS id, "N_ROL_USUARIO" AS nombre
+  FROM "T_ROLES_USUARIO"
+  ORDER BY "ID_ROL_USUARIO";
+END;
+$$;
+```
+
+### 2. Consumir la función desde Node.js
+```ts
+import { PgFunction } from 'pg-functions';
+
+type RolRecord = {
+  id: number;
+  nombre: string;
+};
+
+export const obtenerRoles = async (): Promise<RolRecord[] | null> => {
+  const func = new PgFunction<RolRecord>('fn_obtener_roles_usuario', []);
+  return await func.execute();
+};
+```
+
+# Opcional: Logger personalizado
+
+```ts
+import { setLogger } from 'pg-functions';
+import pino from 'pino';
+
+setLogger(pino({ level: 'info' }));
+```
+
+# API
+
+| Clase                        | Descripción                                                |
+| ---------------------------- | ---------------------------------------------------------- |
+| `PgFunction<T>`              | Ejecuta funciones PL/pgSQL con control transaccional automático (`BEGIN`, `COMMIT`, `ROLLBACK`, `RELEASE`). Ideal para operaciones simples que deben ser atómicas  |
+| `PgFunctionTransactional<T>` | Ejecuta funciones dentro de una transacción controlada manualmente. El desarrollador debe encargarse de realizar `commit()`, `rollback()` y `release()` usando la conexión provista. Útil cuando se deben encadenar múltiples funciones en una misma transacción           |
+| `PgConnection`               | Wrapper de `PoolClient` con manejo de transacciones y logs |
+| `registerPool()`             | Registra el `Pool` global del proyecto                     |
+| `setLogger()`                | Define un logger personalizado                             |

package/dist/PgConnection.d.ts

@@ -0,0 +1,12 @@
+import { PoolClient, QueryResult } from "pg";
+export declare class PgConnection {
+    private readonly connection;
+    constructor(connection: PoolClient);
+    get raw(): PoolClient;
+    query(sql: string, params?: any[]): Promise<QueryResult<any> | null>;
+    begin(): Promise<void>;
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+    release(): void;
+}
+//# sourceMappingURL=PgConnection.d.ts.map

package/dist/PgConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PgConnection.d.ts","sourceRoot":"","sources":["../src/PgConnection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAG7C,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,UAAU;IAInD,IAAI,GAAG,IAAI,UAAU,CAEpB;IAEK,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAUxE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B,OAAO,IAAI,IAAI;CAIhB"}

package/dist/PgConnection.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PgConnection = void 0;
+const utils_1 = require("./utils");
+class PgConnection {
+    constructor(connection) {
+        this.connection = connection;
+        (0, utils_1.getLogger)().info(`Acquired DB connection for function execution.`);
+    }
+    get raw() {
+        return this.connection;
+    }
+    async query(sql, params = []) {
+        (0, utils_1.getLogger)().info(`Executing ${sql} with args: ${JSON.stringify(params)}`);
+        const result = await this.connection.query(sql, params);
+        if (result.rowCount === 0) {
+            (0, utils_1.getLogger)().info(`Function returned no rows.`);
+            return null;
+        }
+        return result;
+    }
+    async begin() {
+        await this.connection.query("BEGIN");
+    }
+    async commit() {
+        await this.connection.query("COMMIT");
+        (0, utils_1.getLogger)().info(`Function executed successfully.`);
+    }
+    async rollback() {
+        await this.connection.query("ROLLBACK");
+        (0, utils_1.getLogger)().error('Error during function execution. Rolled back transaction.');
+    }
+    release() {
+        this.connection.release();
+        (0, utils_1.getLogger)().info(`Connection released.`);
+    }
+}
+exports.PgConnection = PgConnection;
+//# sourceMappingURL=PgConnection.js.map

package/dist/PgConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PgConnection.js","sourceRoot":"","sources":["../src/PgConnection.ts"],"names":[],"mappings":";;;AACA,mCAAoC;AAEpC,MAAa,YAAY;IACvB,YAA6B,UAAsB;QAAtB,eAAU,GAAV,UAAU,CAAY;QACjD,IAAA,iBAAS,GAAE,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAA;IACpE,CAAC;IAED,IAAI,GAAG;QACH,OAAO,IAAI,CAAC,UAAU,CAAA;IAC1B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,SAAgB,EAAE;QACzC,IAAA,iBAAS,GAAE,CAAC,IAAI,CAAC,aAAa,GAAG,eAAe,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAA,iBAAS,GAAE,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACtC,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QACrC,IAAA,iBAAS,GAAE,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAA;IACrD,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;QACrC,IAAA,iBAAS,GAAE,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAClF,CAAC;IAED,OAAO;QACL,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAA;QACzB,IAAA,iBAAS,GAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;IAC1C,CAAC;CACF;AArCD,oCAqCC"}

package/dist/context.d.ts

@@ -0,0 +1,4 @@
+import type { Pool } from 'pg';
+export declare function registerPool(pool: Pool): void;
+export declare function getPool(): Pool;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAI/B,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAK7C;AAED,wBAAgB,OAAO,IAAI,IAAI,CAK9B"}

package/dist/context.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPool = registerPool;
+exports.getPool = getPool;
+let appPool;
+function registerPool(pool) {
+    if (appPool) {
+        throw new Error('pg-functions: Ya existe un pool registrado. Solo se permite un pool por aplicación.');
+    }
+    appPool = pool;
+}
+function getPool() {
+    if (!appPool) {
+        throw new Error('pg-functions: No se ha registrado un pool. Asegúrate de llamar a registerPool antes de usar getPool.');
+    }
+    return appPool;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":";;AAIA,oCAKC;AAED,0BAKC;AAdD,IAAI,OAAyB,CAAC;AAE9B,SAAgB,YAAY,CAAC,IAAU;IACrC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,qFAAqF,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC;AAED,SAAgB,OAAO;IACrB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sGAAsG,CAAC,CAAC;IAC1H,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/enum/SqlMode.enum.d.ts

@@ -0,0 +1,5 @@
+export declare enum SqlMode {
+    DEFAULT = "DEFAULT",
+    SCALAR = "SCALAR"
+}
+//# sourceMappingURL=SqlMode.enum.d.ts.map

package/dist/enum/SqlMode.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqlMode.enum.d.ts","sourceRoot":"","sources":["../../src/enum/SqlMode.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,OAAO;IACf,OAAO,YAAY;IACnB,MAAM,WAAW;CACpB"}

package/dist/enum/SqlMode.enum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqlMode = void 0;
+var SqlMode;
+(function (SqlMode) {
+    SqlMode["DEFAULT"] = "DEFAULT";
+    SqlMode["SCALAR"] = "SCALAR";
+})(SqlMode || (exports.SqlMode = SqlMode = {}));
+//# sourceMappingURL=SqlMode.enum.js.map

package/dist/enum/SqlMode.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqlMode.enum.js","sourceRoot":"","sources":["../../src/enum/SqlMode.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,OAGX;AAHD,WAAY,OAAO;IACf,8BAAmB,CAAA;IACnB,4BAAiB,CAAA;AACrB,CAAC,EAHW,OAAO,uBAAP,OAAO,QAGlB"}

package/dist/functions/PgFunction.d.ts

@@ -0,0 +1,8 @@
+import { Common } from "../interfaces/Common";
+import { PgFunctionBase } from "./PgFunctionBase";
+export declare class PgFunction<T> extends PgFunctionBase implements Common<T> {
+    constructor(funtionName: string, functionArgs: any[]);
+    execute(): Promise<T[] | null>;
+    executeScalar(): Promise<T | null>;
+}
+//# sourceMappingURL=PgFunction.d.ts.map

package/dist/functions/PgFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PgFunction.d.ts","sourceRoot":"","sources":["../../src/functions/PgFunction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKlD,qBAAa,UAAU,CAAC,CAAC,CAAE,SAAQ,cAAe,YAAW,MAAM,CAAC,CAAC,CAAC;gBACxD,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE;IAI9C,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;IAmB9B,aAAa,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CAuBzC"}

package/dist/functions/PgFunction.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PgFunction = void 0;
+const PgFunctionBase_1 = require("./PgFunctionBase");
+const context_1 = require("../context");
+const PgConnection_1 = require("../PgConnection");
+const SqlMode_enum_1 = require("../enum/SqlMode.enum");
+class PgFunction extends PgFunctionBase_1.PgFunctionBase {
+    constructor(funtionName, functionArgs) {
+        super(funtionName, functionArgs);
+    }
+    async execute() {
+        const connection = new PgConnection_1.PgConnection(await (0, context_1.getPool)().connect());
+        try {
+            await connection.begin();
+            const result = await connection.query(this.sql(), super.getfunctionArgs());
+            if (!result) {
+                return null;
+            }
+            await connection.commit();
+            return result.rows;
+        }
+        catch (error) {
+            await connection.rollback();
+            throw error;
+        }
+        finally {
+            connection.release();
+        }
+    }
+    async executeScalar() {
+        const connection = new PgConnection_1.PgConnection(await (0, context_1.getPool)().connect());
+        try {
+            await connection.begin();
+            const result = await connection.query(this.sql(SqlMode_enum_1.SqlMode.SCALAR), super.getfunctionArgs());
+            if (!result) {
+                return null;
+            }
+            const row = result.rows[0];
+            const value = Object.values(row)[0];
+            await connection.commit();
+            return value;
+        }
+        catch (error) {
+            await connection.rollback();
+            throw error;
+        }
+        finally {
+            connection.release();
+        }
+    }
+}
+exports.PgFunction = PgFunction;
+//# sourceMappingURL=PgFunction.js.map

package/dist/functions/PgFunction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PgFunction.js","sourceRoot":"","sources":["../../src/functions/PgFunction.ts"],"names":[],"mappings":";;;AACA,qDAAkD;AAClD,wCAAoC;AACpC,kDAA+C;AAC/C,uDAA+C;AAE/C,MAAa,UAAc,SAAQ,+BAAc;IAC/C,YAAY,WAAmB,EAAE,YAAmB;QAChD,KAAK,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,UAAU,GAAG,IAAI,2BAAY,CAAC,MAAM,IAAA,iBAAO,GAAE,CAAC,OAAO,EAAE,CAAC,CAAA;QAC9D,IAAI,CAAC;YACH,MAAM,UAAU,CAAC,KAAK,EAAE,CAAA;YACxB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC,CAAA;YAC1E,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,IAAI,CAAA;YACb,CAAC;YAED,MAAM,UAAU,CAAC,MAAM,EAAE,CAAA;YACzB,OAAO,MAAM,CAAC,IAAW,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAA;YAC3B,MAAM,KAAK,CAAA;QACb,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,OAAO,EAAE,CAAA;QACtB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,UAAU,GAAG,IAAI,2BAAY,CAAC,MAAM,IAAA,iBAAO,GAAE,CAAC,OAAO,EAAE,CAAC,CAAA;QAC9D,IAAI,CAAC;YACH,MAAM,UAAU,CAAC,KAAK,EAAE,CAAA;YACxB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAO,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC,CAAA;YACxF,IAAI,CAAC,MAAM,EAAE,CAAC;gBACV,OAAO,IAAI,CAAC;YAChB,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAEpC,MAAM,UAAU,CAAC,MAAM,EAAE,CAAA;YACzB,OAAO,KAAU,CAAA;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAA;YAC3B,MAAM,KAAK,CAAA;QACb,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,OAAO,EAAE,CAAA;QACtB,CAAC;IACH,CAAC;CAGF;AA/CD,gCA+CC"}

package/dist/functions/PgFunctionBase.d.ts

@@ -0,0 +1,11 @@
+import { SqlMode } from "../enum/SqlMode.enum";
+import { Base } from "../interfaces/Base";
+export declare abstract class PgFunctionBase implements Base {
+    private readonly functionName;
+    private readonly functionArgs;
+    constructor(functionName: string, functionArgs: any[]);
+    sql(mode?: SqlMode): string;
+    getPlaceHolders(): string;
+    getfunctionArgs(): string[];
+}
+//# sourceMappingURL=PgFunctionBase.d.ts.map

package/dist/functions/PgFunctionBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PgFunctionBase.d.ts","sourceRoot":"","sources":["../../src/functions/PgFunctionBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAEzC,8BAAsB,cAAe,YAAW,IAAI;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAO;gBAExB,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE;IAKrD,GAAG,CAAC,IAAI,GAAE,OAAyB,GAAG,MAAM;IAM5C,eAAe,IAAI,MAAM;IAIzB,eAAe,IAAI,MAAM,EAAE;CAG9B"}

package/dist/functions/PgFunctionBase.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PgFunctionBase = void 0;
+const SqlMode_enum_1 = require("../enum/SqlMode.enum");
+class PgFunctionBase {
+    constructor(functionName, functionArgs) {
+        this.functionName = functionName;
+        this.functionArgs = functionArgs;
+    }
+    sql(mode = SqlMode_enum_1.SqlMode.DEFAULT) {
+        const prefix = mode === SqlMode_enum_1.SqlMode.SCALAR ? 'SELECT' : 'SELECT * FROM';
+        const suffix = mode === SqlMode_enum_1.SqlMode.SCALAR ? ' AS result' : '';
+        return `${prefix} ${this.functionName}(${this.getPlaceHolders()})${suffix};`;
+    }
+    getPlaceHolders() {
+        return this.functionArgs.length ? this.functionArgs.map((_, i) => `$${i + 1}`).join(', ') : '';
+    }
+    getfunctionArgs() {
+        return this.functionArgs;
+    }
+}
+exports.PgFunctionBase = PgFunctionBase;
+//# sourceMappingURL=PgFunctionBase.js.map

package/dist/functions/PgFunctionBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PgFunctionBase.js","sourceRoot":"","sources":["../../src/functions/PgFunctionBase.ts"],"names":[],"mappings":";;;AAAA,uDAA8C;AAG9C,MAAsB,cAAc;IAIhC,YAAY,YAAoB,EAAE,YAAmB;QACjD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;IACpC,CAAC;IAED,GAAG,CAAC,OAAgB,sBAAO,CAAC,OAAO;QAC/B,MAAM,MAAM,GAAG,IAAI,KAAK,sBAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAA;QACnE,MAAM,MAAM,GAAG,IAAI,KAAK,sBAAO,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;QAC1D,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,eAAe,EAAE,IAAI,MAAM,GAAG,CAAA;IAChF,CAAC;IAED,eAAe;QACX,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAClG,CAAC;IAED,eAAe;QACX,OAAO,IAAI,CAAC,YAAY,CAAA;IAC5B,CAAC;CACJ;AAtBD,wCAsBC"}

package/dist/functions/PgFunctionTransactional.d.ts

@@ -0,0 +1,9 @@
+import { PgFunctionBase } from "./PgFunctionBase";
+import { Transactional } from "../interfaces/Transactional";
+import { PgConnection } from "PgConnection";
+export declare class PgFunctionTransactional<T = any> extends PgFunctionBase implements Transactional<T> {
+    constructor(functionName: string, functionArgs: any[]);
+    execute(connection: PgConnection): Promise<T[] | null>;
+    executeScalar(connection: PgConnection): Promise<T | null>;
+}
+//# sourceMappingURL=PgFunctionTransactional.d.ts.map

package/dist/functions/PgFunctionTransactional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PgFunctionTransactional.d.ts","sourceRoot":"","sources":["../../src/functions/PgFunctionTransactional.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,qBAAa,uBAAuB,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,cAAe,YAAW,aAAa,CAAC,CAAC,CAAC;gBAClF,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE;IAI/C,OAAO,CAAC,UAAU,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;IAStD,aAAa,CAAC,UAAU,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CAWjE"}

package/dist/functions/PgFunctionTransactional.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PgFunctionTransactional = void 0;
+const PgFunctionBase_1 = require("./PgFunctionBase");
+const SqlMode_enum_1 = require("../enum/SqlMode.enum");
+class PgFunctionTransactional extends PgFunctionBase_1.PgFunctionBase {
+    constructor(functionName, functionArgs) {
+        super(functionName, functionArgs);
+    }
+    async execute(connection) {
+        const result = await connection.query(this.sql(), this.getfunctionArgs());
+        if (!result) {
+            return null;
+        }
+        return result.rows;
+    }
+    async executeScalar(connection) {
+        const result = await connection.query(this.sql(SqlMode_enum_1.SqlMode.SCALAR), this.getfunctionArgs());
+        if (!result) {
+            return null;
+        }
+        const row = result.rows[0];
+        const value = Object.values(row)[0];
+        return value;
+    }
+}
+exports.PgFunctionTransactional = PgFunctionTransactional;
+//# sourceMappingURL=PgFunctionTransactional.js.map

package/dist/functions/PgFunctionTransactional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PgFunctionTransactional.js","sourceRoot":"","sources":["../../src/functions/PgFunctionTransactional.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAElD,uDAA+C;AAG/C,MAAa,uBAAiC,SAAQ,+BAAc;IAClE,YAAY,YAAoB,EAAE,YAAmB;QACjD,KAAK,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;IACrC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAwB;QACpC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,MAAM,CAAC,IAAW,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,UAAwB;QAC1C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;QACxF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QAChB,CAAC;QAEC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE3B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACnC,OAAO,KAAU,CAAA;IACnB,CAAC;CACF;AAzBD,0DAyBC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./PgConnection";
+export * from "./context";
+export * from "./functions/PgFunction";
+export * from "./functions/PgFunctionTransactional";
+export * from "./utils/logger";
+export * from "./utils";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,wBAAwB,CAAA;AACtC,cAAc,qCAAqC,CAAA;AACnD,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./PgConnection"), exports);
+__exportStar(require("./context"), exports);
+__exportStar(require("./functions/PgFunction"), exports);
+__exportStar(require("./functions/PgFunctionTransactional"), exports);
+__exportStar(require("./utils/logger"), exports);
+__exportStar(require("./utils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA8B;AAC9B,4CAAyB;AACzB,yDAAsC;AACtC,sEAAmD;AACnD,iDAA8B;AAC9B,0CAAuB"}

package/dist/interfaces/Base.d.ts

@@ -0,0 +1,4 @@
+export interface Base {
+    sql(): string;
+}
+//# sourceMappingURL=Base.d.ts.map

package/dist/interfaces/Base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Base.d.ts","sourceRoot":"","sources":["../../src/interfaces/Base.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACjB,GAAG,IAAI,MAAM,CAAC;CACjB"}

package/dist/interfaces/Base.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Base.js.map

package/dist/interfaces/Base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Base.js","sourceRoot":"","sources":["../../src/interfaces/Base.ts"],"names":[],"mappings":""}

package/dist/interfaces/Common.d.ts

@@ -0,0 +1,5 @@
+export interface Common<T> {
+    executeScalar(): Promise<T | null>;
+    execute(): Promise<T[] | null>;
+}
+//# sourceMappingURL=Common.d.ts.map

package/dist/interfaces/Common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Common.d.ts","sourceRoot":"","sources":["../../src/interfaces/Common.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM,CAAC,CAAC;IACrB,aAAa,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACnC,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;CAClC"}

package/dist/interfaces/Common.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Common.js.map

package/dist/interfaces/Common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Common.js","sourceRoot":"","sources":["../../src/interfaces/Common.ts"],"names":[],"mappings":""}

package/dist/interfaces/ILogger.d.ts

@@ -0,0 +1,6 @@
+export interface ILogger {
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+}
+//# sourceMappingURL=ILogger.d.ts.map

package/dist/interfaces/ILogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogger.d.ts","sourceRoot":"","sources":["../../src/interfaces/ILogger.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IAEtB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC9C"}

package/dist/interfaces/ILogger.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ILogger.js.map

package/dist/interfaces/ILogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogger.js","sourceRoot":"","sources":["../../src/interfaces/ILogger.ts"],"names":[],"mappings":""}

package/dist/interfaces/Transactional.d.ts

@@ -0,0 +1,6 @@
+import { PgConnection } from "PgConnection";
+export interface Transactional<T> {
+    executeScalar(connection: PgConnection): Promise<T | null>;
+    execute(connection: PgConnection): Promise<T[] | null>;
+}
+//# sourceMappingURL=Transactional.d.ts.map

package/dist/interfaces/Transactional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transactional.d.ts","sourceRoot":"","sources":["../../src/interfaces/Transactional.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,aAAa,CAAC,UAAU,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,UAAU,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;CACxD"}

package/dist/interfaces/Transactional.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Transactional.js.map

package/dist/interfaces/Transactional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transactional.js","sourceRoot":"","sources":["../../src/interfaces/Transactional.ts"],"names":[],"mappings":""}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+import { ILogger } from "../interfaces/ILogger";
+export declare const setLogger: (customLogger: ILogger) => void;
+export declare const getLogger: () => ILogger;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAKhD,eAAO,MAAM,SAAS,GAAI,cAAc,OAAO,SAE9C,CAAC;AAEF,eAAO,MAAM,SAAS,QAAO,OAE5B,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLogger = exports.setLogger = void 0;
+const logger_1 = require("./logger");
+let globalLogger = new logger_1.ConsoleLogger();
+const setLogger = (customLogger) => {
+    globalLogger = customLogger;
+};
+exports.setLogger = setLogger;
+const getLogger = () => {
+    return globalLogger;
+};
+exports.getLogger = getLogger;
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;AACA,qCAAyC;AAEzC,IAAI,YAAY,GAAY,IAAI,sBAAa,EAAE,CAAA;AAExC,MAAM,SAAS,GAAG,CAAC,YAAqB,EAAE,EAAE;IACjD,YAAY,GAAG,YAAY,CAAC;AAC9B,CAAC,CAAC;AAFW,QAAA,SAAS,aAEpB;AAEK,MAAM,SAAS,GAAG,GAAY,EAAE;IACrC,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAFW,QAAA,SAAS,aAEpB"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,10 @@
+import { ILogger } from '../interfaces/ILogger';
+export declare class ConsoleLogger implements ILogger {
+    private logger;
+    constructor(customLogger?: ILogger);
+    private formatMessage;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhD,qBAAa,aAAc,YAAW,OAAO;IAC3C,OAAO,CAAC,MAAM,CAAS;gBACX,YAAY,CAAC,EAAE,OAAO;IAMlC,OAAO,CAAC,aAAa;IAIrB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAG3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAG3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;CAG7C"}

package/dist/utils/logger.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleLogger = void 0;
+const pino_1 = __importDefault(require("pino"));
+class ConsoleLogger {
+    constructor(customLogger) {
+        this.logger = customLogger || (0, pino_1.default)({
+            level: process.env.PG_FUNCTIONS_LOG_LEVEL || 'info'
+        });
+    }
+    formatMessage(message) {
+        return `pg-functions: ${message}`;
+    }
+    info(message, ...args) {
+        this.logger.info(this.formatMessage(message), ...args);
+    }
+    warn(message, ...args) {
+        this.logger.warn(this.formatMessage(message), ...args);
+    }
+    error(message, ...args) {
+        this.logger.error(this.formatMessage(message), ...args);
+    }
+}
+exports.ConsoleLogger = ConsoleLogger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;;;;;AACA,gDAAwB;AAExB,MAAa,aAAa;IAExB,YAAY,YAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,YAAY,IAAI,IAAA,cAAI,EAAC;YACjC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,MAAM;SACpD,CAAC,CAAC;IACL,CAAC;IAEO,aAAa,CAAC,OAAe;QACnC,OAAO,iBAAiB,OAAO,EAAE,CAAC;IACpC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACzD,CAAC;IACD,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1D,CAAC;CACF;AArBD,sCAqBC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "pg-functions",
+  "version": "1.0.0",
+  "description": "",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsc"
+  },
+  "peerDependencies": {
+    "pg": "^8.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/pg": "^8.0.0",
+    "pg": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [],
+  "author": "mfbasta",
+  "license": "MIT",
+  "dependencies": {
+    "pino": "^9.7.0"
+  }
+}