@dbcube/core 5.2.2 → 5.2.4

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;
@@ -141,28 +141,39 @@ export declare class QueryEngine {
 	getConfig(): any;
 	run(binary: string, args: string[]): Promise<ResponseEngine>;
 	private argsToCommand;
+	/** El motor embebido (FFI) es el camino por defecto cuando la librería
+	 *  nativa está disponible; el daemon TCP queda como fallback y como modo
+	 *  multi-proceso explícito. */
+	private useEmbedded;
 	/**
-	 * Executes a DML plan over the persistent TCP server.
+	 * Executes a DML plan. Embedded engine when available (in-process FFI,
+	 * no network hop); persistent TCP daemon otherwise.
 	 * Pass txId to run it inside an active transaction.
 	 */
 	executeDml(dml: object, txId?: string): Promise<ResponseEngine>;
 	/**
-	 * Executes raw SQL (or a MongoDB command document) with bound parameters
-	 * over the persistent TCP server.
+	 * Atomic batch: N write plans inside one transaction with a single
+	 * engine round-trip. Falls back to begin/ops/commit over the daemon
+	 * when the embedded engine is not available.
+	 */
+	executeBatch(ops: object[]): Promise<ResponseEngine>;
+	/**
+	 * Executes raw SQL (or a MongoDB command document) with bound parameters.
 	 */
 	rawQuery(query: string, params?: any[], txId?: string): Promise<ResponseEngine>;
-	/** Starts a server-side transaction and returns its id. */
+	/** Starts a transaction and returns its id. */
 	beginTransaction(): Promise<string>;
 	commitTransaction(txId: string): Promise<void>;
 	rollbackTransaction(txId: string): Promise<void>;
 	private executeWithTcpServer;
+	private poolFor;
+	private acquireSocket;
+	private releaseSocket;
 	private waitForServerReady;
 	private isServerResponding;
 	private sleep;
 	private getCachedDML;
 	private startTcpServer;
-	private sendTcpRequestFast;
-	private processQueue;
 	private createNewConnection;
 	private executeOnConnection;
 	private createProcess;
@@ -222,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;
@@ -269,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>;

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;
@@ -141,28 +141,39 @@ export declare class QueryEngine {
 	getConfig(): any;
 	run(binary: string, args: string[]): Promise<ResponseEngine>;
 	private argsToCommand;
+	/** El motor embebido (FFI) es el camino por defecto cuando la librería
+	 *  nativa está disponible; el daemon TCP queda como fallback y como modo
+	 *  multi-proceso explícito. */
+	private useEmbedded;
 	/**
-	 * Executes a DML plan over the persistent TCP server.
+	 * Executes a DML plan. Embedded engine when available (in-process FFI,
+	 * no network hop); persistent TCP daemon otherwise.
 	 * Pass txId to run it inside an active transaction.
 	 */
 	executeDml(dml: object, txId?: string): Promise<ResponseEngine>;
 	/**
-	 * Executes raw SQL (or a MongoDB command document) with bound parameters
-	 * over the persistent TCP server.
+	 * Atomic batch: N write plans inside one transaction with a single
+	 * engine round-trip. Falls back to begin/ops/commit over the daemon
+	 * when the embedded engine is not available.
+	 */
+	executeBatch(ops: object[]): Promise<ResponseEngine>;
+	/**
+	 * Executes raw SQL (or a MongoDB command document) with bound parameters.
 	 */
 	rawQuery(query: string, params?: any[], txId?: string): Promise<ResponseEngine>;
-	/** Starts a server-side transaction and returns its id. */
+	/** Starts a transaction and returns its id. */
 	beginTransaction(): Promise<string>;
 	commitTransaction(txId: string): Promise<void>;
 	rollbackTransaction(txId: string): Promise<void>;
 	private executeWithTcpServer;
+	private poolFor;
+	private acquireSocket;
+	private releaseSocket;
 	private waitForServerReady;
 	private isServerResponding;
 	private sleep;
 	private getCachedDML;
 	private startTcpServer;
-	private sendTcpRequestFast;
-	private processQueue;
 	private createNewConnection;
 	private executeOnConnection;
 	private createProcess;
@@ -222,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;
@@ -269,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>;