@dbcube/core 5.1.13 → 5.1.15

package/dist/index.d.mts

@@ -11,8 +11,27 @@ export declare class Engine {
 	private arguments;
 	private binary;
 	private timeout;
+	private daemonFailed;
 	constructor(name: string, timeout?: number);
 	initializeBinary(): Promise<void>;
+	/**
+	 * Returns a connected DaemonClient for this database, or null when
+	 * daemon mode is disabled/unavailable (then callers use spawn mode).
+	 */
+	private getDaemon;
+	/**
+	 * Executes a DML plan. Uses the persistent daemon (sub-millisecond
+	 * overhead) when available; falls back to one-shot spawn otherwise.
+	 */
+	executeDml(dml: object, txId?: string): Promise<ResponseEngine>;
+	/**
+	 * Executes raw SQL (or a MongoDB command document) with bound parameters.
+	 */
+	rawQuery(query: string, params?: any[], txId?: string): Promise<ResponseEngine>;
+	/** Starts a transaction (daemon mode only). Returns the transaction id. */
+	beginTransaction(): Promise<string>;
+	commitTransaction(txId: string): Promise<void>;
+	rollbackTransaction(txId: string): Promise<void>;
 	setArguments(): any[];
 	setConfig(name: string): {
 		[x: string]: any;
@@ -202,6 +221,57 @@ export declare class Config {
 	 */
 	getAllDatabases(): Record<string, DatabaseConfig$1>;
 }
+export interface DaemonResponse {
+	status: number;
+	message: string;
+	data: any;
+}
+/**
+ * TCP client for the query-engine daemon (server mode).
+ *
+ * Instead of spawning a new engine process per query (30-80ms overhead),
+ * the daemon keeps the engine alive with warm connection pools and serves
+ * requests over a local TCP socket in <1ms. One daemon per database name.
+ */
+export declare class DaemonClient {
+	private static registry;
+	private name;
+	private binaryPath;
+	private engineArgs;
+	private socket;
+	private buffer;
+	private pending;
+	private starting;
+	private requestTimeout;
+	private constructor();
+	static get(name: string, binaryPath: string, engineArgs: string[]): DaemonClient;
+	static isEnabled(): boolean;
+	private portfilePath;
+	/**
+	 * Ensures a usable daemon connection. Returns false when the daemon
+	 * can't be used (old binary, startup failure) so callers fall back
+	 * to one-shot spawn mode.
+	 */
+	ensure(): Promise<boolean>;
+	private connectOrStart;
+	private readPortfile;
+	private spawnDaemon;
+	private tryConnect;
+	private attach;
+	private detach;
+	private onData;
+	/**
+	 * Sends a request to the daemon. Responses arrive in FIFO order on the
+	 * single socket, so pending requests resolve in send order.
+	 */
+	send(payload: Record<string, any>): Promise<DaemonResponse>;
+	execute(dml: object, txId?: string): Promise<DaemonResponse>;
+	raw(query: string, params?: any[], txId?: string): Promise<DaemonResponse>;
+	begin(): Promise<string>;
+	commit(txId: string): Promise<void>;
+	rollback(txId: string): Promise<void>;
+	shutdown(): Promise<void>;
+}
 export interface InterceptOptions {
 	interceptLog?: boolean;
 	interceptError?: boolean;

package/dist/index.d.ts

@@ -11,8 +11,27 @@ export declare class Engine {
 	private arguments;
 	private binary;
 	private timeout;
+	private daemonFailed;
 	constructor(name: string, timeout?: number);
 	initializeBinary(): Promise<void>;
+	/**
+	 * Returns a connected DaemonClient for this database, or null when
+	 * daemon mode is disabled/unavailable (then callers use spawn mode).
+	 */
+	private getDaemon;
+	/**
+	 * Executes a DML plan. Uses the persistent daemon (sub-millisecond
+	 * overhead) when available; falls back to one-shot spawn otherwise.
+	 */
+	executeDml(dml: object, txId?: string): Promise<ResponseEngine>;
+	/**
+	 * Executes raw SQL (or a MongoDB command document) with bound parameters.
+	 */
+	rawQuery(query: string, params?: any[], txId?: string): Promise<ResponseEngine>;
+	/** Starts a transaction (daemon mode only). Returns the transaction id. */
+	beginTransaction(): Promise<string>;
+	commitTransaction(txId: string): Promise<void>;
+	rollbackTransaction(txId: string): Promise<void>;
 	setArguments(): any[];
 	setConfig(name: string): {
 		[x: string]: any;
@@ -202,6 +221,57 @@ export declare class Config {
 	 */
 	getAllDatabases(): Record<string, DatabaseConfig$1>;
 }
+export interface DaemonResponse {
+	status: number;
+	message: string;
+	data: any;
+}
+/**
+ * TCP client for the query-engine daemon (server mode).
+ *
+ * Instead of spawning a new engine process per query (30-80ms overhead),
+ * the daemon keeps the engine alive with warm connection pools and serves
+ * requests over a local TCP socket in <1ms. One daemon per database name.
+ */
+export declare class DaemonClient {
+	private static registry;
+	private name;
+	private binaryPath;
+	private engineArgs;
+	private socket;
+	private buffer;
+	private pending;
+	private starting;
+	private requestTimeout;
+	private constructor();
+	static get(name: string, binaryPath: string, engineArgs: string[]): DaemonClient;
+	static isEnabled(): boolean;
+	private portfilePath;
+	/**
+	 * Ensures a usable daemon connection. Returns false when the daemon
+	 * can't be used (old binary, startup failure) so callers fall back
+	 * to one-shot spawn mode.
+	 */
+	ensure(): Promise<boolean>;
+	private connectOrStart;
+	private readPortfile;
+	private spawnDaemon;
+	private tryConnect;
+	private attach;
+	private detach;
+	private onData;
+	/**
+	 * Sends a request to the daemon. Responses arrive in FIFO order on the
+	 * single socket, so pending requests resolve in send order.
+	 */
+	send(payload: Record<string, any>): Promise<DaemonResponse>;
+	execute(dml: object, txId?: string): Promise<DaemonResponse>;
+	raw(query: string, params?: any[], txId?: string): Promise<DaemonResponse>;
+	begin(): Promise<string>;
+	commit(txId: string): Promise<void>;
+	rollback(txId: string): Promise<void>;
+	shutdown(): Promise<void>;
+}
 export interface InterceptOptions {
 	interceptLog?: boolean;
 	interceptError?: boolean;