@dbcube/core 5.2.3 → 5.2.5

package/dist/index.d.mts

@@ -129,7 +129,7 @@ export declare class QueryEngine {
 	private timeout;
 	private connectionId;
 	private tcpPort;
-	constructor(name: string, timeout?: number);
+	constructor(name: string, timeout?: number, explicitConfig?: any);
 	private generatePort;
 	private findAvailablePort;
 	private isPortAvailable;
@@ -233,35 +233,6 @@ export declare class Binary {
 	private static findVersionedBinary;
 	static get(): Promise<BinaryType$1>;
 }
-export interface SqliteResult {
-	status: "success" | "error";
-	message: string;
-	data: any | null;
-}
-export interface RunResult {
-	changes: number;
-	lastID: number;
-}
-declare class SqliteExecutor {
-	private binaryPath;
-	private dbPath;
-	constructor(dbPath: string);
-	private findVersionedBinary;
-	private getBinaryPath;
-	private executeBinary;
-	connect(): Promise<boolean>;
-	exists(): Promise<boolean>;
-	query(sql: string, params?: any[]): Promise<SqliteResult>;
-	queryMultiple(sql: string): Promise<SqliteResult>;
-	prepare(sql: string): {
-		all: (...params: any[]) => Promise<any[]>;
-		run: (...params: any[]) => Promise<RunResult>;
-	};
-	prepareSync(sql: string): {
-		all: (...params: any[]) => any;
-		run: (...params: any[]) => any;
-	};
-}
 export interface DatabaseConfig {
 	name?: string;
 	HOST?: string;
@@ -280,11 +251,17 @@ export interface ParametrizedQueryResult {
 	parameters: any[];
 }
 declare class SQLite {
-	private executor;
-	private database?;
+	private database;
+	private engine;
 	constructor(config: DatabaseConfig);
+	/** Ruta del archivo SQLite interno (.dbcube/<database>.db). */
+	private dbFilePath;
+	/** QueryEngine sqlite apuntando al archivo interno, con config explícito
+	 *  (no vive en dbcube.config.js). La ruta relativa `.dbcube/<db>` deja que
+	 *  QueryEngine le añada `.db` → `.dbcube/<db>.db`, relativo al CWD. */
+	private getEngine;
 	ifExist(): Promise<Boolean>;
-	connect(): Promise<SqliteExecutor>;
+	connect(): Promise<QueryEngine>;
 	disconnect(): Promise<void>;
 	query(sqlQuery: string): Promise<QueryResult>;
 	queryWithParameters(sqlQuery: string, params?: any[]): Promise<QueryResult>;
@@ -513,5 +490,31 @@ export declare class TableProcessor {
 export declare class TriggerProcessor {
 	static getTriggers(name: string): Promise<any[]>;
 }
+/**
+ * Cargador de variables de entorno propio de DBCube.
+ *
+ * Evita que el usuario tenga que instalar `dotenv` y escribir
+ * `require("dotenv").config()` al inicio de su dbcube.config.js. DBCube carga
+ * el `.env` del proyecto automáticamente ANTES de evaluar la configuración.
+ *
+ * Estrategia:
+ *   1. `process.loadEnvFile()` — nativo de Node 20.6+ (cero dependencias).
+ *   2. Fallback: parser propio mínimo (KEY=VALUE, comillas, comentarios, export).
+ *
+ * No sobrescribe variables ya presentes en process.env (las del shell mandan).
+ */
+export declare class EnvLoader {
+	/**
+	 * Carga el archivo .env indicado (o ./.env del cwd) en process.env.
+	 * Silencioso si el archivo no existe. Devuelve true si cargó algo.
+	 */
+	static load(envPath?: string): boolean;
+	/**
+	 * Parser mínimo de formato .env. Soporta:
+	 *   KEY=value · KEY="value con espacios" · KEY='literal' · export KEY=value
+	 *   comentarios con # · líneas en blanco · \n \t en comillas dobles.
+	 */
+	static parse(content: string): Record<string, string>;
+}
 
 export {};

package/dist/index.d.ts

@@ -129,7 +129,7 @@ export declare class QueryEngine {
 	private timeout;
 	private connectionId;
 	private tcpPort;
-	constructor(name: string, timeout?: number);
+	constructor(name: string, timeout?: number, explicitConfig?: any);
 	private generatePort;
 	private findAvailablePort;
 	private isPortAvailable;
@@ -233,35 +233,6 @@ export declare class Binary {
 	private static findVersionedBinary;
 	static get(): Promise<BinaryType$1>;
 }
-export interface SqliteResult {
-	status: "success" | "error";
-	message: string;
-	data: any | null;
-}
-export interface RunResult {
-	changes: number;
-	lastID: number;
-}
-declare class SqliteExecutor {
-	private binaryPath;
-	private dbPath;
-	constructor(dbPath: string);
-	private findVersionedBinary;
-	private getBinaryPath;
-	private executeBinary;
-	connect(): Promise<boolean>;
-	exists(): Promise<boolean>;
-	query(sql: string, params?: any[]): Promise<SqliteResult>;
-	queryMultiple(sql: string): Promise<SqliteResult>;
-	prepare(sql: string): {
-		all: (...params: any[]) => Promise<any[]>;
-		run: (...params: any[]) => Promise<RunResult>;
-	};
-	prepareSync(sql: string): {
-		all: (...params: any[]) => any;
-		run: (...params: any[]) => any;
-	};
-}
 export interface DatabaseConfig {
 	name?: string;
 	HOST?: string;
@@ -280,11 +251,17 @@ export interface ParametrizedQueryResult {
 	parameters: any[];
 }
 declare class SQLite {
-	private executor;
-	private database?;
+	private database;
+	private engine;
 	constructor(config: DatabaseConfig);
+	/** Ruta del archivo SQLite interno (.dbcube/<database>.db). */
+	private dbFilePath;
+	/** QueryEngine sqlite apuntando al archivo interno, con config explícito
+	 *  (no vive en dbcube.config.js). La ruta relativa `.dbcube/<db>` deja que
+	 *  QueryEngine le añada `.db` → `.dbcube/<db>.db`, relativo al CWD. */
+	private getEngine;
 	ifExist(): Promise<Boolean>;
-	connect(): Promise<SqliteExecutor>;
+	connect(): Promise<QueryEngine>;
 	disconnect(): Promise<void>;
 	query(sqlQuery: string): Promise<QueryResult>;
 	queryWithParameters(sqlQuery: string, params?: any[]): Promise<QueryResult>;
@@ -513,5 +490,31 @@ export declare class TableProcessor {
 export declare class TriggerProcessor {
 	static getTriggers(name: string): Promise<any[]>;
 }
+/**
+ * Cargador de variables de entorno propio de DBCube.
+ *
+ * Evita que el usuario tenga que instalar `dotenv` y escribir
+ * `require("dotenv").config()` al inicio de su dbcube.config.js. DBCube carga
+ * el `.env` del proyecto automáticamente ANTES de evaluar la configuración.
+ *
+ * Estrategia:
+ *   1. `process.loadEnvFile()` — nativo de Node 20.6+ (cero dependencias).
+ *   2. Fallback: parser propio mínimo (KEY=VALUE, comillas, comentarios, export).
+ *
+ * No sobrescribe variables ya presentes en process.env (las del shell mandan).
+ */
+export declare class EnvLoader {
+	/**
+	 * Carga el archivo .env indicado (o ./.env del cwd) en process.env.
+	 * Silencioso si el archivo no existe. Devuelve true si cargó algo.
+	 */
+	static load(envPath?: string): boolean;
+	/**
+	 * Parser mínimo de formato .env. Soporta:
+	 *   KEY=value · KEY="value con espacios" · KEY='literal' · export KEY=value
+	 *   comentarios con # · líneas en blanco · \n \t en comillas dobles.
+	 */
+	static parse(content: string): Record<string, string>;
+}
 
 export {};