@crane-technologies/database 2.1.0

package/dist/components/Logger.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+/**
+ * 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 });
+ * ```
+ */
+class Logger {
+    constructor(level = 1, prefix = "[DB]") {
+        this.level = level;
+        this.prefix = prefix;
+    }
+    /**
+     * Logs error messages (Level 1+)
+     * @param message - Error message
+     * @param error - Optional error object or additional data
+     */
+    error(message, error) {
+        if (this.level >= 1) {
+            if (error !== undefined && error !== null && error !== "") {
+                console.error(`❌ ${this.prefix} [ERROR] ${message}`, error);
+            }
+            else {
+                console.error(`❌ ${this.prefix} [ERROR] ${message}`);
+            }
+        }
+    }
+    /**
+     * Logs debug information (Level 2+)
+     * @param message - Debug message
+     * @param data - Optional additional data
+     */
+    debug(message, data) {
+        if (this.level >= 2) {
+            // Solo mostrar data si tiene contenido relevante
+            if (data && typeof data === "object") {
+                const cleanData = this.cleanObject(data);
+                if (Object.keys(cleanData).length > 0) {
+                    console.log(`🐛 ${this.prefix} [DEBUG] ${message}`, cleanData);
+                }
+                else {
+                    console.log(`🐛 ${this.prefix} [DEBUG] ${message}`);
+                }
+            }
+            else if (data !== undefined && data !== null && data !== "") {
+                console.log(`🐛 ${this.prefix} [DEBUG] ${message}`, data);
+            }
+            else {
+                console.log(`🐛 ${this.prefix} [DEBUG] ${message}`);
+            }
+        }
+    }
+    /**
+     * Logs warning messages (Level 3+)
+     * @param message - Warning message
+     * @param data - Optional additional data
+     */
+    warn(message, data) {
+        if (this.level >= 3) {
+            if (data && typeof data === "object") {
+                const cleanData = this.cleanObject(data);
+                if (Object.keys(cleanData).length > 0) {
+                    console.warn(`⚠️ ${this.prefix} [WARN] ${message}`, cleanData);
+                }
+                else {
+                    console.warn(`⚠️ ${this.prefix} [WARN] ${message}`);
+                }
+            }
+            else if (data !== undefined && data !== null && data !== "") {
+                console.warn(`⚠️ ${this.prefix} [WARN] ${message}`, data);
+            }
+            else {
+                console.warn(`⚠️ ${this.prefix} [WARN] ${message}`);
+            }
+        }
+    }
+    /**
+     * Logs informational messages (Level 3+)
+     * @param message - Info message
+     * @param data - Optional additional data
+     */
+    info(message, data) {
+        if (this.level >= 3) {
+            if (data && typeof data === "object") {
+                const cleanData = this.cleanObject(data);
+                if (Object.keys(cleanData).length > 0) {
+                    console.log(`ℹ️ ${this.prefix} [INFO] ${message}`, cleanData);
+                }
+                else {
+                    console.log(`ℹ️ ${this.prefix} [INFO] ${message}`);
+                }
+            }
+            else if (data !== undefined && data !== null && data !== "") {
+                console.log(`ℹ️ ${this.prefix} [INFO] ${message}`, data);
+            }
+            else {
+                console.log(`ℹ️ ${this.prefix} [INFO] ${message}`);
+            }
+        }
+    }
+    /**
+     * Limpia un objeto removiendo propiedades undefined, null o vacías
+     * @private
+     */
+    cleanObject(obj) {
+        if (typeof obj !== "object" || obj === null) {
+            return obj;
+        }
+        const cleaned = {};
+        for (const key in obj) {
+            const value = obj[key];
+            if (value !== undefined && value !== null && value !== "") {
+                cleaned[key] = value;
+            }
+        }
+        return cleaned;
+    }
+    /**
+     * Updates the log level dynamically
+     * @param level - New log level (0-3)
+     */
+    setLevel(level) {
+        this.level = level;
+    }
+    /**
+     * Gets the current log level
+     * @returns Current log level
+     */
+    getLevel() {
+        return this.level;
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=Logger.js.map

package/dist/components/Logger.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @module @crane-technologies/database
+ * PostgreSQL Database Component
+ *
+ * Main exports for the database component providing connection pooling,
+ * transactions, and query management.
+ *
+ * @example
+ * ```typescript
+ * import Database, { DatabaseConfig } from '@crane-technologies/database';
+ *
+ * const config: DatabaseConfig = {
+ *   connectionString: process.env.DATABASE_URL,
+ *   ssl: { rejectUnauthorized: false },
+ *   max: 10,
+ *   logLevel: 2
+ * };
+ *
+ * const db = Database.getInstance(config, queries);
+ * ```
+ */
+export { default } from "./components/Database";
+export { default as Database } from "./components/Database";
+export { createQueries, QueryReference } from "./utils/createQueries";
+export { Dependency } from "./interfaces/Dependancy";
+export { DatabaseConfig, LogLevel } from "./interfaces/DatabaseConfig";
+export { Logger } from "./components/Logger";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGtE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAGvE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * @module @crane-technologies/database
+ * PostgreSQL Database Component
+ *
+ * Main exports for the database component providing connection pooling,
+ * transactions, and query management.
+ *
+ * @example
+ * ```typescript
+ * import Database, { DatabaseConfig } from '@crane-technologies/database';
+ *
+ * const config: DatabaseConfig = {
+ *   connectionString: process.env.DATABASE_URL,
+ *   ssl: { rejectUnauthorized: false },
+ *   max: 10,
+ *   logLevel: 2
+ * };
+ *
+ * const db = Database.getInstance(config, queries);
+ * ```
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = exports.createQueries = exports.Database = exports.default = void 0;
+// Main Database class (default export)
+var Database_1 = require("./components/Database");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(Database_1).default; } });
+var Database_2 = require("./components/Database");
+Object.defineProperty(exports, "Database", { enumerable: true, get: function () { return __importDefault(Database_2).default; } });
+// Utility functions
+var createQueries_1 = require("./utils/createQueries");
+Object.defineProperty(exports, "createQueries", { enumerable: true, get: function () { return createQueries_1.createQueries; } });
+// Logger
+var Logger_1 = require("./components/Logger");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return Logger_1.Logger; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;AAEH,uCAAuC;AACvC,kDAAgD;AAAvC,oHAAA,OAAO,OAAA;AAChB,kDAA4D;AAAnD,qHAAA,OAAO,OAAY;AAE5B,oBAAoB;AACpB,uDAAsE;AAA7D,8GAAA,aAAa,OAAA;AAMtB,SAAS;AACT,8CAA6C;AAApC,gGAAA,MAAM,OAAA"}

package/dist/interfaces/BulkInsertOptions.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Options for bulk insert operations, typically used for CSV imports.
+ *
+ * @interface BulkInsertOptions
+ * @property {string} [delimiter] - CSV delimiter character (default is ",").
+ * @property {boolean} [header] - Whether to include a header row with column names.
+ *
+ * @example
+ * ```typescript
+ * const options: BulkInsertOptions = {
+ *   delimiter: ";",
+ *   header: true,
+ * };
+ *```
+ */
+export interface BulkInsertOptions {
+    delimiter?: string;
+    header?: boolean;
+}
+//# sourceMappingURL=BulkInsertOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BulkInsertOptions.d.ts","sourceRoot":"","sources":["../../interfaces/BulkInsertOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/interfaces/BulkInsertOptions.js

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

package/dist/interfaces/BulkInsertOptions.js.map

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

package/dist/interfaces/DatabaseConfig.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Log levels for database operations
+ * 0 = NONE (no logs)
+ * 1 = ERROR (only errors)
+ * 2 = DEBUG (errors + debug info)
+ * 3 = ALL (errors + debug + warnings + info)
+ */
+export type LogLevel = 0 | 1 | 2 | 3;
+/**
+ * Database configuration interface that extends PostgreSQL PoolConfig.
+ * Defines all available options for configuring the database connection pool.
+ *
+ * @interface DatabaseConfig
+ * @property {string} [connectionString] - Database connection string
+ * @property {boolean | { rejectUnauthorized: boolean }} [ssl] - SSL configuration for the connection
+ * @property {number} [max] - Maximum number of clients in the pool
+ * @property {number} [idleTimeoutMillis] - Time a client must sit idle in the pool before being closed
+ * @property {number} [connectionTimeoutMillis] - Time to wait for a connection to be established
+ * @property {number} [statement_timeout] - Maximum allowed duration of any statement
+ * @property {number} [query_timeout] - Maximum allowed duration of any query
+ * @property {boolean} [keepAlive] - Whether to enable TCP keep-alive on the connection
+ * @property {LogLevel} [logLevel] - Logging level: 0=NONE, 1=ERROR, 2=DEBUG, 3=ALL (default: 1)
+ *
+ * @example
+ * ```typescript
+ * const config: DatabaseConfig = {
+ *   connectionString: process.env.DATABASE_URL,
+ *   ssl: { rejectUnauthorized: false },
+ *   max: 10,
+ *   idleTimeoutMillis: 30000,
+ *   connectionTimeoutMillis: 5000,
+ *   statement_timeout: 30000,
+ *   query_timeout: 30000,
+ *   keepAlive: true,
+ *   logLevel: 2, // ERROR + DEBUG
+ * };
+ * ```
+ */
+export interface DatabaseConfig {
+    connectionString?: string;
+    ssl?: boolean | {
+        rejectUnauthorized: boolean;
+    };
+    max?: number;
+    idleTimeoutMillis?: number;
+    connectionTimeoutMillis?: number;
+    statement_timeout?: number;
+    query_timeout?: number;
+    keepAlive?: boolean;
+    logLevel?: LogLevel;
+}
+//# sourceMappingURL=DatabaseConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseConfig.d.ts","sourceRoot":"","sources":["../../interfaces/DatabaseConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,OAAO,GAAG;QAAE,kBAAkB,EAAE,OAAO,CAAA;KAAE,CAAC;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB"}

package/dist/interfaces/DatabaseConfig.js

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

package/dist/interfaces/DatabaseConfig.js.map

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

package/dist/interfaces/Dependancy.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Interface that defines the structure of a dependency between queries in transactions.
+ * Allows the result of a query (sourceIndex) to be used as a parameter in another query (targetIndex).
+ *
+ * @interface Dependency
+ * @property {number} sourceIndex - Index of the source query in the queries array
+ * @property {number} targetIndex - Index of the target query that will receive the value
+ * @property {number} targetParamIndex - Index of the parameter in the target query where the value will be inserted
+ */
+export interface Dependency {
+    sourceIndex: number;
+    targetIndex: number;
+    targetParamIndex: number;
+}
+//# sourceMappingURL=Dependancy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Dependancy.d.ts","sourceRoot":"","sources":["../../interfaces/Dependancy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}

package/dist/interfaces/Dependancy.js

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

package/dist/interfaces/Dependancy.js.map

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

package/dist/interfaces/QueryList.d.ts

@@ -0,0 +1,4 @@
+export interface QueryList {
+    [key: string]: string;
+}
+//# sourceMappingURL=QueryList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QueryList.d.ts","sourceRoot":"","sources":["../../interfaces/QueryList.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB"}

package/dist/interfaces/QueryList.js

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

package/dist/interfaces/QueryList.js.map

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

package/dist/utils/createQueries.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Tipo que representa una referencia a una query con autocompletado.
+ * Contiene el path interno para que Database pueda encontrar el SQL.
+ */
+export type QueryReference = {
+    __queryKey: string;
+    sql: string;
+    toString: () => string;
+    valueOf: () => string;
+};
+/**
+ * Función principal que convierte queries (planas o anidadas) en objetos con autocompletado.
+ * NO requiere desestructuración manual. El objeto retornado ya contiene todo.
+ *
+ * @param queries - Objeto con queries (soporta planas, anidadas o mixtas)
+ * @returns Objeto con queries accesibles directamente y __flatMap interno
+ *
+ * @example
+ * ```typescript
+ * // ✅ Caso 1: Queries planas (SIN desestructurar)
+ * const queries = createQueries({
+ *   getUser: "SELECT * FROM users WHERE id = $1",
+ *   createUser: "INSERT INTO users (name) VALUES ($1) RETURNING *"
+ * });
+ *
+ * const db = Database.getInstance(config, queries);
+ * await db.query(queries.getUser, [123]);
+ * await db.query(queries.createUser, ["John"]);
+ *
+ * // ✅ Caso 2: Queries anidadas (SIN desestructurar)
+ * const queries = createQueries({
+ *   users: {
+ *     getById: "SELECT * FROM users WHERE id = $1",
+ *     create: "INSERT INTO users..."
+ *   },
+ *   products: {
+ *     getAll: "SELECT * FROM products"
+ *   }
+ * });
+ *
+ * const db = Database.getInstance(config, queries);
+ * await db.query(queries.users.getById, [123]);
+ * await db.query(queries.products.getAll);
+ *
+ * // ✅ Caso 3: Queries mixtas (SIN desestructurar)
+ * const queries = createQueries({
+ *   connection: "SELECT NOW()",
+ *   users: {
+ *     getById: "SELECT * FROM users WHERE id = $1"
+ *   }
+ * });
+ *
+ * const db = Database.getInstance(config, queries);
+ * await db.query(queries.connection);
+ * await db.query(queries.users.getById, [123]);
+ *
+ * // ✅ OPCIONAL: Desestructurar solo si quieres
+ * const { users, products } = queries;
+ * await db.query(users.getById, [123]);
+ * ```
+ */
+export declare function createQueries<T extends Record<string, any>>(queries: T): T & {
+    __flatMap: Record<string, string>;
+};
+//# sourceMappingURL=createQueries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createQueries.d.ts","sourceRoot":"","sources":["../../utils/createQueries.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,GA2E5C,CAAC,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CACnE"}

package/dist/utils/createQueries.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createQueries = createQueries;
+/**
+ * Función principal que convierte queries (planas o anidadas) en objetos con autocompletado.
+ * NO requiere desestructuración manual. El objeto retornado ya contiene todo.
+ *
+ * @param queries - Objeto con queries (soporta planas, anidadas o mixtas)
+ * @returns Objeto con queries accesibles directamente y __flatMap interno
+ *
+ * @example
+ * ```typescript
+ * // ✅ Caso 1: Queries planas (SIN desestructurar)
+ * const queries = createQueries({
+ *   getUser: "SELECT * FROM users WHERE id = $1",
+ *   createUser: "INSERT INTO users (name) VALUES ($1) RETURNING *"
+ * });
+ *
+ * const db = Database.getInstance(config, queries);
+ * await db.query(queries.getUser, [123]);
+ * await db.query(queries.createUser, ["John"]);
+ *
+ * // ✅ Caso 2: Queries anidadas (SIN desestructurar)
+ * const queries = createQueries({
+ *   users: {
+ *     getById: "SELECT * FROM users WHERE id = $1",
+ *     create: "INSERT INTO users..."
+ *   },
+ *   products: {
+ *     getAll: "SELECT * FROM products"
+ *   }
+ * });
+ *
+ * const db = Database.getInstance(config, queries);
+ * await db.query(queries.users.getById, [123]);
+ * await db.query(queries.products.getAll);
+ *
+ * // ✅ Caso 3: Queries mixtas (SIN desestructurar)
+ * const queries = createQueries({
+ *   connection: "SELECT NOW()",
+ *   users: {
+ *     getById: "SELECT * FROM users WHERE id = $1"
+ *   }
+ * });
+ *
+ * const db = Database.getInstance(config, queries);
+ * await db.query(queries.connection);
+ * await db.query(queries.users.getById, [123]);
+ *
+ * // ✅ OPCIONAL: Desestructurar solo si quieres
+ * const { users, products } = queries;
+ * await db.query(users.getById, [123]);
+ * ```
+ */
+function createQueries(queries) {
+    // flatMap: diccionario plano para Database
+    // "users.getById" -> "SELECT * FROM users WHERE id = $1"
+    // "getUser" -> "SELECT * FROM users WHERE id = $1"
+    const flatMap = {};
+    /**
+     * Función recursiva que aplana queries (planas o anidadas)
+     *
+     * Ejemplos:
+     * - getUser: "SELECT..." -> "getUser": "SELECT..."
+     * - users: { getById: "SELECT..." } -> "users.getById": "SELECT..."
+     */
+    function flatten(obj, prefix = "") {
+        for (const [key, value] of Object.entries(obj)) {
+            const fullKey = prefix ? `${prefix}.${key}` : key;
+            if (typeof value === "string") {
+                // Es un SQL string, guardarlo en flatMap
+                flatMap[fullKey] = value;
+            }
+            else if (typeof value === "object" && value !== null) {
+                // Es un objeto anidado, continuar recursivamente
+                flatten(value, fullKey);
+            }
+        }
+    }
+    // Aplanar todas las queries (planas y anidadas)
+    flatten(queries);
+    /**
+     * Proxy que intercepta el acceso a las propiedades
+     * Maneja tanto queries planas como anidadas
+     */
+    function createProxy(target, path = []) {
+        return new Proxy(target, {
+            get(obj, prop) {
+                // Permitir acceso a __flatMap
+                if (prop === "__flatMap") {
+                    return flatMap;
+                }
+                // Ignorar símbolos internos de Node.js
+                if (typeof prop === "symbol") {
+                    return undefined;
+                }
+                const value = obj[prop];
+                // CASO 1: Es un string (SQL) - Query plana o hoja de anidación
+                if (typeof value === "string") {
+                    const fullPath = [...path, prop].join(".");
+                    return {
+                        __queryKey: fullPath,
+                        sql: value,
+                        toString: () => fullPath,
+                        valueOf: () => fullPath,
+                    };
+                }
+                // CASO 2: Es un objeto - Query anidada
+                if (typeof value === "object" && value !== null) {
+                    return createProxy(value, [...path, prop]);
+                }
+                return value;
+            },
+        });
+    }
+    // Crear el proxy con las queries
+    const proxiedQueries = createProxy(queries);
+    // Retornar el proxy directamente con __flatMap accesible
+    return proxiedQueries;
+}
+//# sourceMappingURL=createQueries.js.map

package/dist/utils/createQueries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createQueries.js","sourceRoot":"","sources":["../../utils/createQueries.ts"],"names":[],"mappings":";;AA8DA,sCA4EC;AA/HD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,SAAgB,aAAa,CAAgC,OAAU;IACrE,2CAA2C;IAC3C,yDAAyD;IACzD,mDAAmD;IACnD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C;;;;;;OAMG;IACH,SAAS,OAAO,CAAC,GAAQ,EAAE,SAAiB,EAAE;QAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAElD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,yCAAyC;gBACzC,OAAO,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;YAC3B,CAAC;iBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACvD,iDAAiD;gBACjD,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjB;;;OAGG;IACH,SAAS,WAAW,CAAC,MAAW,EAAE,OAAiB,EAAE;QACnD,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE;YACvB,GAAG,CAAC,GAAG,EAAE,IAAY;gBACnB,8BAA8B;gBAC9B,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;oBACzB,OAAO,OAAO,CAAC;gBACjB,CAAC;gBAED,uCAAuC;gBACvC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC7B,OAAO,SAAS,CAAC;gBACnB,CAAC;gBAED,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;gBAExB,+DAA+D;gBAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC9B,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAE3C,OAAO;wBACL,UAAU,EAAE,QAAQ;wBACpB,GAAG,EAAE,KAAK;wBACV,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ;wBACxB,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ;qBACN,CAAC;gBACtB,CAAC;gBAED,uCAAuC;gBACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAChD,OAAO,WAAW,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;gBAC7C,CAAC;gBAED,OAAO,KAAK,CAAC;YACf,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,iCAAiC;IACjC,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAE5C,yDAAyD;IACzD,OAAO,cAA2D,CAAC;AACrE,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@crane-technologies/database",
+  "version": "2.1.0",
+  "description": "PostgreSQL database component with connection pooling, transactions, dependency management and TypeScript autocomplete",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "test": "tsx test.ts",
+    "dev": "tsx test.ts",
+    "test:watch": "tsx watch test.ts",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "postgresql",
+    "postgres",
+    "database",
+    "pool",
+    "transaction",
+    "sql",
+    "pg",
+    "crane",
+    "typescript",
+    "autocomplete",
+    "queries",
+    "typesafe"
+  ],
+  "author": "Crane",
+  "license": "MIT",
+  "type": "commonjs",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Crane/database.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Crane/database/issues"
+  },
+  "homepage": "https://github.com/Crane/database#readme",
+  "dependencies": {
+    "pg": "^8.0.0",
+    "pg-copy-streams": "^7.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.9.1",
+    "@types/pg": "^8.15.5",
+    "@types/pg-copy-streams": "^1.2.5",
+    "rimraf": "^6.0.1",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}