@crane-technologies/database 2.1.0

package/dist/components/Database.js

@@ -0,0 +1,554 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const pg_1 = require("pg");
+const pg_copy_streams_1 = require("pg-copy-streams");
+const stream_1 = require("stream");
+const Logger_1 = require("./Logger");
+/**
+ * Database class implements the Singleton pattern to manage PostgreSQL connections.
+ * Provides methods for executing SQL queries, transactions and dependency handling.
+ * Supports QueryReference objects for autocomplete.
+ *
+ * @class Database
+ * @example
+ * ```typescript
+ * import Database, { createQueries } from '@crane-technologies/database';
+ *
+ * const queries = createQueries({
+ *   users: {
+ *     getById: "SELECT * FROM users WHERE id = $1"
+ *   }
+ * });
+ *
+ * const db = Database.getInstance(config, queries);
+ *
+ * // ✅ Con autocompletado
+ * await db.query(queries.users.getById, [123]);
+ * ```
+ */
+class Database {
+    /**
+     * Private constructor that implements the Singleton pattern.
+     * Use getInstance() to get the Database instance.
+     *
+     * @param {DatabaseConfig} config - Database configuration
+     * @param {Record<string, string>} flatMap - Flat map of queries
+     * @private
+     */
+    constructor(config, flatMap) {
+        this.config = config;
+        this.queries = flatMap;
+        this.logger = new Logger_1.Logger(config.logLevel ?? 1, "[DATABASE]");
+        this.initializePool();
+    }
+    /**
+     * Initializes the PostgreSQL connection pool using provided configuration.
+     * Executed only once when creating the first singleton instance.
+     *
+     * @private
+     * @returns {void}
+     * @throws {Error} If pool initialization fails
+     */
+    initializePool() {
+        try {
+            this.pool = new pg_1.Pool(this.config);
+            this.pool.on("connect", () => {
+                this.logger.info("Nueva conexión establecida a la base de datos");
+            });
+            this.pool.on("error", (error) => {
+                this.logger.error("Error en el pool de conexiones", error);
+            });
+            this.pool.on("remove", () => {
+                this.logger.debug("Conexión removida del pool");
+            });
+            this.logger.info("Pool de conexiones inicializado correctamente");
+        }
+        catch (error) {
+            this.logger.error("Error inicializando el pool", error);
+            throw new Error(`Failed to initialize connection pool: ${error}`);
+        }
+    }
+    /**
+     * Static method to get the unique Database instance (Singleton pattern).
+     * Accepts the result of createQueries() or a plain object with queries.
+     *
+     * @param {DatabaseConfig} config - Database configuration (required on first call)
+     * @param {any} queries - Result from createQueries() or plain query object
+     * @returns {Database} The unique Database instance
+     * @throws {Error} If config is not provided on first initialization
+     *
+     * @example
+     * ```typescript
+     * // With createQueries (recommended)
+     * const queries = createQueries({
+     *   users: { getById: "SELECT * FROM users WHERE id = $1" }
+     * });
+     * const db = Database.getInstance(config, queries);
+     * await db.query(queries.users.getById, [123]);
+     *
+     * // With plain object (backward compatible)
+     * const db = Database.getInstance(config, {
+     *   getUser: "SELECT * FROM users WHERE id = $1"
+     * });
+     * await db.query("getUser", [123]);
+     * ```
+     */
+    static getInstance(config, queries) {
+        if (!Database.instance) {
+            if (!queries) {
+                throw new Error("Queries must be provided on first initialization");
+            }
+            // Detect if comes from createQueries() (has __flatMap)
+            const flatMap = queries.__flatMap || queries;
+            Database.instance = new Database(config, flatMap);
+        }
+        else {
+            // Merge new queries if provided
+            if (queries) {
+                const flatMap = queries.__flatMap || queries;
+                if (Object.keys(flatMap).length > 0) {
+                    Database.instance.queries = {
+                        ...Database.instance.queries,
+                        ...flatMap,
+                    };
+                    Database.instance.logger.debug("New queries added", {
+                        count: Object.keys(flatMap).length,
+                    });
+                }
+            }
+        }
+        return Database.instance;
+    }
+    /**
+     * Validates that the pool is active and ready to accept connections.
+     *
+     * @private
+     * @throws {Error} If pool is closed or not initialized
+     */
+    ensurePoolActive() {
+        if (!this.pool || this.pool.ended) {
+            const error = new Error("Database pool is closed. Cannot execute queries.");
+            this.logger.error(error.message);
+            throw error;
+        }
+    }
+    /**
+     * Extracts the SQL from a QueryReference or string key.
+     *
+     * @private
+     * @param query - QueryReference, string key, or raw SQL
+     * @returns The SQL query string
+     * @throws {Error} If query is not found
+     */
+    getQuery(query) {
+        // Case 1: It's a QueryReference
+        if (typeof query === "object" && query !== null && "__queryKey" in query) {
+            const queryKey = query.__queryKey;
+            const sql = this.queries[queryKey];
+            if (!sql) {
+                const error = new Error(`Query "${queryKey}" not found in queries dictionary. ` +
+                    `Available queries: ${Object.keys(this.queries).join(", ")}`);
+                this.logger.error(error.message);
+                throw error;
+            }
+            return sql;
+        }
+        // CASE 2: It's a string
+        if (typeof query === "string") {
+            // Search in the dictionary
+            const sql = this.queries[query];
+            if (sql) {
+                return sql;
+            }
+            // If not found, treat as raw SQL
+            return query;
+        }
+        throw new Error("Invalid query type. Expected QueryReference or string.");
+    }
+    /**
+     * Gets the SQL query string.
+     *
+     * @private
+     * @param query - QueryReference or string
+     * @returns The SQL query string
+     */
+    getQueryName(query) {
+        if (typeof query === "object" && query !== null && "__queryKey" in query) {
+            return query.__queryKey;
+        }
+        if (typeof query === "string") {
+            return this.queries[query] ? query : "raw_sql";
+        }
+        return "unknown";
+    }
+    /**
+     * Executes a predefined SQL query using QueryReference or string key.
+     * Gets a connection from the pool, executes the query and releases the connection.
+     *
+     * @param {string | QueryReference} query - QueryReference object or query key
+     * @param {any[]} params - Optional parameters for the SQL query
+     * @returns {Promise<QueryResult>} SQL query result
+     * @throws {Error} If the query doesn't exist or execution fails
+     *
+     * @example
+     * ```typescript
+     * // With QueryReference (autocomplete!)
+     * const result = await db.queryList(queries.users.getById, [123]);
+     *
+     * // With string key (backward compatible)
+     * const result = await db.queryList("users.getById", [123]);
+     * ```
+     */
+    async queryList(query, params) {
+        this.ensurePoolActive();
+        const sqlText = this.getQuery(query);
+        const queryName = this.getQueryName(query);
+        const client = await this.pool.connect();
+        try {
+            this.logger.debug(`Executing query: ${queryName}`, { params });
+            const res = await client.query({
+                text: sqlText,
+                values: params,
+            });
+            this.logger.debug(`Query executed successfully: ${queryName}`, {
+                rowCount: res.rowCount,
+            });
+            return res;
+        }
+        catch (error) {
+            this.logger.error(`Error executing query: ${queryName}`, error);
+            throw error;
+        }
+        finally {
+            client.release();
+            this.logger.debug("Client released back to pool");
+        }
+    }
+    /**
+     * Executes a direct SQL query (raw SQL text).
+     * Useful for dynamic queries that are not predefined in the dictionary.
+     * Gets a connection from the pool, executes the query and releases the connection.
+     *
+     * @param {string} sqlText - The complete SQL text of the query to execute
+     * @param {any[]} params - Optional parameters for the SQL query
+     * @returns {Promise<QueryResult>} SQL query result
+     * @throws {Error} If query execution fails
+     *
+     * @example
+     * ```typescript
+     * const result = await db.rawQuery("SELECT COUNT(*) FROM users WHERE active = $1", [true]);
+     * const count = result.rows[0].count;
+     * ```
+     */
+    async rawQuery(sqlText, params) {
+        this.ensurePoolActive();
+        const client = await this.pool.connect();
+        try {
+            this.logger.debug("Executing raw query", { sqlText });
+            const res = await client.query({
+                text: sqlText,
+                values: params,
+            });
+            this.logger.debug("Raw query executed successfully", {
+                rowCount: res.rowCount,
+            });
+            return res;
+        }
+        catch (error) {
+            this.logger.error("Error executing raw query", error);
+            throw error;
+        }
+        finally {
+            client.release();
+            this.logger.debug("Client released back to pool");
+        }
+    }
+    /**
+     * Performs a high-performance bulk insert using PostgreSQL's native COPY ... FROM STDIN.
+     * Accepts an array of rows and streams them as CSV to the database.
+     * This is significantly faster than multiple INSERT statements.
+     *
+     * @param {string} table - The target table name.
+     * @param {string[]} columns - Array of column names to insert into (order matters).
+     * @param {(string | number | boolean | Date | null | undefined)[][]} rows - Array of row arrays, each representing a record.
+     * @param {BulkInsertOptions} [options] - Optional CSV formatting options (delimiter, header).
+     * @returns {Promise<{ inserted: number }>} Number of rows successfully inserted.
+     * @throws {Error} If the operation fails or the pool is not active.
+     *
+     * @example
+     * ```typescript
+     * await db.bulkInsert(
+     *   "users",
+     *   ["name", "email"],
+     *   [
+     *     ["Alice", "alice@email.com"],
+     *     ["Bob", "bob@email.com"]
+     *   ],
+     *   { header: false }
+     * );
+     * ```
+     */
+    async bulkInsert(table, columns, rows, options) {
+        this.ensurePoolActive();
+        const delimiter = options?.delimiter ?? ",";
+        const includeHeader = options?.header ?? false;
+        // Use quoteIdentifier for table and columns
+        const quotedTable = this.quoteIdentifier(table);
+        const quotedColumns = columns
+            .map((col) => this.quoteIdentifier(col))
+            .join(", ");
+        const copySql = `COPY ${quotedTable} (${quotedColumns}) FROM STDIN WITH (FORMAT csv, DELIMITER '${delimiter}', HEADER ${includeHeader ? "true" : "false"})`;
+        const client = await this.pool.connect();
+        try {
+            const copyStream = client.query((0, pg_copy_streams_1.from)(copySql));
+            const csvStream = stream_1.Readable.from(this.generateCsvLines(columns, rows, delimiter, includeHeader));
+            await new Promise((resolve, reject) => {
+                csvStream.on("error", reject);
+                copyStream.on("error", reject);
+                copyStream.on("finish", resolve);
+                csvStream.pipe(copyStream);
+            });
+            this.logger.info("Bulk insert ejecutado", {
+                table,
+                rows: rows.length,
+            });
+            return { inserted: rows.length };
+        }
+        catch (error) {
+            this.logger.error("Error en bulk insert", error);
+            throw error;
+        }
+        finally {
+            client.release();
+            this.logger.debug("Client release tras bulk insert");
+        }
+    }
+    /**
+     * Generator that yields CSV lines for bulk insert operations.
+     * Optionally includes a header row with column names.
+     * Each yielded value is a CSV-formatted string representing a row.
+     *
+     * @private
+     * @param {string[]} columns - Array of column names.
+     * @param {(string | number | boolean | Date | null | undefined)[][]} rows - Array of row arrays.
+     * @param {string} delimiter - CSV delimiter character.
+     * @param {boolean} includeHeader - Whether to include a header row.
+     * @yields {string} CSV-formatted line.
+     */
+    *generateCsvLines(columns, rows, delimiter, includeHeader) {
+        if (includeHeader) {
+            yield columns.join(delimiter) + "\n";
+        }
+        for (const row of rows) {
+            const values = row
+                .map((value) => this.escapeCsvValue(value, delimiter))
+                .join(delimiter);
+            yield values + "\n";
+        }
+    }
+    /**
+     * Escapes a single value for safe inclusion in a CSV line.
+     * Handles delimiters, quotes, and line breaks according to CSV rules.
+     *
+     * @private
+     * @param {string | number | boolean | Date | null | undefined} value - The value to escape.
+     * @param {string} delimiter - The CSV delimiter character.
+     * @returns {string} The escaped CSV value.
+     */
+    escapeCsvValue(value, delimiter) {
+        if (value === null || value === undefined) {
+            return "";
+        }
+        const text = String(value).replace(/"/g, '""');
+        const needsQuotes = text.includes(delimiter) ||
+            text.includes("\n") ||
+            text.includes("\r") ||
+            text.includes('"');
+        return needsQuotes ? `"${text}"` : text;
+    }
+    /**
+     * Safely quotes a SQL identifier (such as a table or column name) for use in queries.
+     * Escapes any double quotes within the identifier to prevent SQL injection or syntax errors.
+     *
+     * @private
+     * @param {string} identifier - The SQL identifier to quote (e.g., table or column name).
+     * @returns {string} The quoted and escaped identifier, safe for use in SQL statements.
+     *
+     * @example
+     * const quoted = db.quoteIdentifier('user"name');
+     * // quoted === '"user""name"'
+     */
+    quoteIdentifier(identifier) {
+        return `"${identifier.replace(/"/g, '""')}"`;
+    }
+    /**
+     * Smart method that executes queries automatically detecting the type.
+     * Supports QueryReference objects (from createQueries), string keys, or raw SQL.
+     *
+     * @param {string | QueryReference} query - QueryReference, query key, or raw SQL
+     * @param {any[]} params - Optional parameters for the SQL query
+     * @returns {Promise<QueryResult>} SQL query result
+     * @throws {Error} If query execution fails
+     *
+     * @example
+     * ```typescript
+     * // Using QueryReference (autocomplete!)
+     * const user = await db.query(queries.users.getById, [123]);
+     *
+     * // Using string key (backward compatible)
+     * const user = await db.query("users.getById", [123]);
+     *
+     * // Using raw SQL
+     * const products = await db.query("SELECT * FROM products WHERE price > $1", [100]);
+     * ```
+     */
+    async query(query, params) {
+        this.ensurePoolActive();
+        try {
+            // If it's a QueryReference or a known key
+            if ((typeof query === "object" && "__queryKey" in query) ||
+                (typeof query === "string" && this.queries[query])) {
+                return await this.queryList(query, params);
+            }
+            else {
+                // Otherwise, treat as raw SQL
+                return await this.rawQuery(query, params);
+            }
+        }
+        catch (error) {
+            this.logger.error("Error executing query", error);
+            throw error;
+        }
+    }
+    /**
+     * Executes multiple SQL queries within an atomic transaction.
+     * All queries execute or fail together (ACID compliance).
+     * Supports dependencies between queries, where the result of one query
+     * can be used as a parameter in subsequent queries.
+     * Supports QueryReference objects with autocomplete.
+     *
+     * @param {(string | QueryReference)[]} queryArray - Array of QueryReferences or query keys
+     * @param {any[][]} paramsArray - Array of arrays with parameters for each query
+     * @param {Dependency[]} dependencies - Optional array of dependencies between queries
+     * @returns {Promise<QueryResult[]>} Array with the results of all queries
+     * @throws {Error} If any query fails, the entire transaction is rolled back
+     *
+     * @example
+     * ```typescript
+     * // With QueryReference (autocomplete!)
+     * const results = await db.transaction(
+     *   [queries.users.create, queries.profiles.create],
+     *   [
+     *     ["John", "john@email.com"],
+     *     [null, "Profile description"]
+     *   ],
+     *   [{ sourceIndex: 0, targetIndex: 1, targetParamIndex: 0 }]
+     * );
+     *
+     * // With string keys (backward compatible)
+     * const results = await db.transaction(
+     *   ["users.create", "profiles.create"],
+     *   [["John", "john@email.com"], [null, "Profile description"]],
+     *   [{ sourceIndex: 0, targetIndex: 1, targetParamIndex: 0 }]
+     * );
+     * ```
+     */
+    async transaction(queryArray, paramsArray, dependencies = []) {
+        this.ensurePoolActive();
+        if (queryArray.length !== paramsArray.length) {
+            const error = new Error("queryArray and paramsArray must have the same length");
+            this.logger.error(error.message);
+            throw error;
+        }
+        const client = await this.pool.connect();
+        try {
+            await client.query("BEGIN");
+            this.logger.info("Transaction started", {
+                queries: queryArray.length,
+            });
+            const results = [];
+            for (let i = 0; i < queryArray.length; i++) {
+                const queryInput = queryArray[i];
+                const sqlText = this.getQuery(queryInput);
+                const queryName = this.getQueryName(queryInput);
+                const params = paramsArray[i];
+                this.logger.debug(`Executing transaction query ${i + 1}/${queryArray.length}`, { query: queryName });
+                const res = await client.query(sqlText, params);
+                results.push(res);
+                // Handle dependencies: use the first value of the result as ID
+                if (res.rows[0] &&
+                    typeof res.rows[0] === "object" &&
+                    res.rows[0] !== null) {
+                    const firstRow = res.rows[0];
+                    const id = Object.values(firstRow)[0];
+                    dependencies.forEach((dep) => {
+                        if (dep.sourceIndex === i) {
+                            paramsArray[dep.targetIndex][dep.targetParamIndex] = id;
+                            this.logger.debug("Dependency resolved", {
+                                from: i,
+                                to: dep.targetIndex,
+                                value: id,
+                            });
+                        }
+                    });
+                }
+            }
+            await client.query("COMMIT");
+            this.logger.info("Transaction committed successfully", {
+                results: results.length,
+            });
+            return results;
+        }
+        catch (error) {
+            await client.query("ROLLBACK");
+            this.logger.warn("Transaction rolled back due to error");
+            this.logger.error("Error executing transaction", error);
+            throw error;
+        }
+        finally {
+            client.release();
+            this.logger.debug("Transaction client released");
+        }
+    }
+    /**
+     * Closes all connections in the pool and cleans up resources.
+     * Should be called before application shutdown or when the database is no longer needed.
+     * After calling this method, the singleton instance is reset and a new one can be created.
+     *
+     * @returns {Promise<void>}
+     * @throws {Error} If there's an error closing the pool
+     *
+     * @example
+     * ```typescript
+     * process.on('SIGTERM', async () => {
+     *   const db = Database.getInstance();
+     *   await db.close();
+     *   process.exit(0);
+     * });
+     * ```
+     */
+    async close() {
+        try {
+            if (this.pool && !this.pool.ended) {
+                await this.pool.end();
+                this.logger.info("Pool closed successfully");
+            }
+            // Reset singleton instance to allow recreation
+            Database.instance = null;
+        }
+        catch (error) {
+            this.logger.error("Error closing database pool:", error);
+            throw new Error(`Error closing database pool: ${error}`);
+        }
+    }
+    /**
+     * Updates the log level dynamically
+     * @param level - New log level (0-3)
+     */
+    setLogLevel(level) {
+        this.logger.setLevel(level);
+        this.logger.info(`Log level changed to ${level}`);
+    }
+}
+exports.default = Database;
+//# sourceMappingURL=Database.js.map

package/dist/components/Database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.js","sourceRoot":"","sources":["../../components/Database.ts"],"names":[],"mappings":"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"}

package/dist/components/Logger.d.ts

@@ -0,0 +1,63 @@
+import { LogLevel } from "@/interfaces/DatabaseConfig";
+/**
+ * Logger class that handles database operation logs based on configured log level.
+ *
+ * Log Levels:
+ * - 0 (NONE): No logging
+ * - 1 (ERROR): Only errors
+ * - 2 (DEBUG): Errors + debug information
+ * - 3 (ALL): Errors + debug + warnings + info
+ *
+ * @class Logger
+ * @example
+ * ```typescript
+ * const logger = new Logger(2); // ERROR + DEBUG
+ * logger.error("Connection failed", error);
+ * logger.debug("Query executed", { rowCount: 5 });
+ * ```
+ */
+export declare class Logger {
+    private level;
+    private prefix;
+    constructor(level?: LogLevel, prefix?: string);
+    /**
+     * Logs error messages (Level 1+)
+     * @param message - Error message
+     * @param error - Optional error object or additional data
+     */
+    error(message: string, error?: unknown): void;
+    /**
+     * Logs debug information (Level 2+)
+     * @param message - Debug message
+     * @param data - Optional additional data
+     */
+    debug(message: string, data?: unknown): void;
+    /**
+     * Logs warning messages (Level 3+)
+     * @param message - Warning message
+     * @param data - Optional additional data
+     */
+    warn(message: string, data?: unknown): void;
+    /**
+     * Logs informational messages (Level 3+)
+     * @param message - Info message
+     * @param data - Optional additional data
+     */
+    info(message: string, data?: unknown): void;
+    /**
+     * Limpia un objeto removiendo propiedades undefined, null o vacías
+     * @private
+     */
+    private cleanObject;
+    /**
+     * Updates the log level dynamically
+     * @param level - New log level (0-3)
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Gets the current log level
+     * @returns Current log level
+     */
+    getLevel(): LogLevel;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/components/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../components/Logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,MAAM;IAGL,OAAO,CAAC,KAAK;IAFzB,OAAO,CAAC,MAAM,CAAS;gBAEH,KAAK,GAAE,QAAY,EAAE,MAAM,GAAE,MAAe;IAIhE;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAU7C;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAkB5C;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAiB3C;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAiB3C;;;OAGG;IACH,OAAO,CAAC,WAAW;IAenB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B;;;OAGG;IACH,QAAQ,IAAI,QAAQ;CAGrB"}