@carllee1983/dbcli 1.46.0 → 1.47.1

package/dist/core.d.ts

@@ -355,13 +355,13 @@ export declare class BlacklistError extends Error {
  * Enables system-aware instantiation without coupling CLI commands to specific drivers
  */
 export declare class AdapterFactory {
-	static createSqlAdapter(options: SqlConnectionOptions): DatabaseAdapter;
-	static createQueryableAdapter(options: QueryableConnectionOptions): QueryableAdapter;
+	static createSqlAdapter(rawOptions: SqlConnectionOptions): DatabaseAdapter;
+	static createQueryableAdapter(rawOptions: QueryableConnectionOptions): QueryableAdapter;
 	static createAdapter(options: SqlConnectionOptions): DatabaseAdapter;
 	static createAdapter(options: QueryableConnectionOptions): QueryableAdapter;
 	static createAdapter(options: ConnectionOptions): DatabaseAdapter | QueryableAdapter;
 	static createMongoDBAdapter(options: ConnectionOptions): QueryableAdapter;
-	static createRedisAdapter(options: ConnectionOptions, blacklistRules?: string[], maskRules?: RedisMaskRule[]): QueryableAdapter;
+	static createRedisAdapter(rawOptions: ConnectionOptions, blacklistRules?: string[], maskRules?: RedisMaskRule[]): QueryableAdapter;
 	static createElasticsearchAdapter(options: ConnectionOptions): QueryableAdapter;
 }
 /**
@@ -560,6 +560,12 @@ export interface QueryResult<T> {
 	/** Internal row-limit proof, mapped into public JSON metadata by the formatter. */
 	appliedLimit?: AppliedLimitMetadata;
 }
+declare const SQL_DIALECTS: readonly [
+	"postgresql",
+	"mysql",
+	"mariadb"
+];
+type SqlDialect = (typeof SQL_DIALECTS)[number];
 /**
  * Manager class for loading and querying blacklist rules.
  * Instantiate once per CLI invocation.
@@ -668,6 +674,7 @@ export declare class BlacklistValidator {
 declare const DbcliConfigSchema: z.ZodObject<{
 	connection: z.ZodUnion<[
 		z.ZodObject<{
+			timeout: z.ZodOptional<z.ZodNumber>;
 			system: z.ZodEnum<[
 				"postgresql",
 				"mysql",
@@ -740,6 +747,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			database: string | {
 				$env: string;
 			};
+			timeout?: number | undefined;
 		}, {
 			user: string | {
 				$env: string;
@@ -754,11 +762,13 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			database: string | {
 				$env: string;
 			};
+			timeout?: number | undefined;
 			password?: string | {
 				$env: string;
 			} | undefined;
 		}>,
 		z.ZodObject<{
+			timeout: z.ZodOptional<z.ZodNumber>;
 			system: z.ZodLiteral<"mongodb">;
 			uri: z.ZodOptional<z.ZodUnion<[
 				z.ZodString,
@@ -860,6 +870,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 				$env: string;
 			};
 			srv: boolean;
+			timeout?: number | undefined;
 			authSource?: string | {
 				$env: string;
 			} | undefined;
@@ -872,6 +883,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			} | undefined;
 		}, {
 			system: "mongodb";
+			timeout?: number | undefined;
 			password?: string | {
 				$env: string;
 			} | undefined;
@@ -900,6 +912,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			} | undefined;
 		}>,
 		z.ZodObject<{
+			timeout: z.ZodOptional<z.ZodNumber>;
 			system: z.ZodLiteral<"redis">;
 			host: z.ZodUnion<[
 				z.ZodString,
@@ -968,6 +981,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			database: string | {
 				$env: string;
 			};
+			timeout?: number | undefined;
 		}, {
 			system: "redis";
 			host: string | {
@@ -976,6 +990,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			port: number | {
 				$env: string;
 			};
+			timeout?: number | undefined;
 			password?: string | {
 				$env: string;
 			} | undefined;
@@ -987,6 +1002,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			} | undefined;
 		}>,
 		z.ZodObject<{
+			timeout: z.ZodOptional<z.ZodNumber>;
 			system: z.ZodLiteral<"elasticsearch">;
 			protocol: z.ZodDefault<z.ZodOptional<z.ZodEnum<[
 				"http",
@@ -1084,6 +1100,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			};
 			rejectUnauthorized: boolean;
 			protocol: "http" | "https";
+			timeout?: number | undefined;
 			nodes?: string[] | undefined;
 			cloudId?: string | {
 				$env: string;
@@ -1094,6 +1111,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			caPath?: string | undefined;
 		}, {
 			system: "elasticsearch";
+			timeout?: number | undefined;
 			password?: string | {
 				$env: string;
 			} | undefined;
@@ -1238,6 +1256,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			$env: string;
 		};
 		srv: boolean;
+		timeout?: number | undefined;
 		authSource?: string | {
 			$env: string;
 		} | undefined;
@@ -1265,6 +1284,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		database: string | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 	} | {
 		password: string | {
 			$env: string;
@@ -1282,6 +1302,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		database: string | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 	} | {
 		password: string | {
 			$env: string;
@@ -1301,6 +1322,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		};
 		rejectUnauthorized: boolean;
 		protocol: "http" | "https";
+		timeout?: number | undefined;
 		nodes?: string[] | undefined;
 		cloudId?: string | {
 			$env: string;
@@ -1320,6 +1342,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 }, {
 	connection: {
 		system: "mongodb";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -1360,6 +1383,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		database: string | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -1371,6 +1395,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		port: number | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -1382,6 +1407,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		} | undefined;
 	} | {
 		system: "elasticsearch";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -1443,6 +1469,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 	default: z.ZodString;
 	connections: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnion<[
 		z.ZodObject<{
+			timeout: z.ZodOptional<z.ZodNumber>;
 			system: z.ZodEnum<[
 				"postgresql",
 				"mysql",
@@ -1525,6 +1552,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 				$env: string;
 			};
 			permission: "admin" | "query-only" | "read-write" | "data-admin";
+			timeout?: number | undefined;
 			envFile?: string | undefined;
 			environment?: string | undefined;
 		}, {
@@ -1541,6 +1569,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			database: string | {
 				$env: string;
 			};
+			timeout?: number | undefined;
 			password?: string | {
 				$env: string;
 			} | undefined;
@@ -1549,6 +1578,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			environment?: string | undefined;
 		}>,
 		z.ZodObject<{
+			timeout: z.ZodOptional<z.ZodNumber>;
 			system: z.ZodLiteral<"mongodb">;
 			uri: z.ZodOptional<z.ZodUnion<[
 				z.ZodString,
@@ -1660,6 +1690,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			};
 			srv: boolean;
 			permission: "admin" | "query-only" | "read-write" | "data-admin";
+			timeout?: number | undefined;
 			authSource?: string | {
 				$env: string;
 			} | undefined;
@@ -1674,6 +1705,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			environment?: string | undefined;
 		}, {
 			system: "mongodb";
+			timeout?: number | undefined;
 			password?: string | {
 				$env: string;
 			} | undefined;
@@ -1705,6 +1737,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			environment?: string | undefined;
 		}>,
 		z.ZodObject<{
+			timeout: z.ZodOptional<z.ZodNumber>;
 			system: z.ZodLiteral<"redis">;
 			host: z.ZodUnion<[
 				z.ZodString,
@@ -1783,6 +1816,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 				$env: string;
 			};
 			permission: "admin" | "query-only" | "read-write" | "data-admin";
+			timeout?: number | undefined;
 			envFile?: string | undefined;
 			environment?: string | undefined;
 		}, {
@@ -1793,6 +1827,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			port: number | {
 				$env: string;
 			};
+			timeout?: number | undefined;
 			password?: string | {
 				$env: string;
 			} | undefined;
@@ -1807,6 +1842,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			environment?: string | undefined;
 		}>,
 		z.ZodObject<{
+			timeout: z.ZodOptional<z.ZodNumber>;
 			system: z.ZodLiteral<"elasticsearch">;
 			protocol: z.ZodDefault<z.ZodOptional<z.ZodEnum<[
 				"http",
@@ -1914,6 +1950,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			rejectUnauthorized: boolean;
 			protocol: "http" | "https";
 			permission: "admin" | "query-only" | "read-write" | "data-admin";
+			timeout?: number | undefined;
 			nodes?: string[] | undefined;
 			cloudId?: string | {
 				$env: string;
@@ -1926,6 +1963,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			environment?: string | undefined;
 		}, {
 			system: "elasticsearch";
+			timeout?: number | undefined;
 			password?: string | {
 				$env: string;
 			} | undefined;
@@ -1973,6 +2011,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			$env: string;
 		};
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
+		timeout?: number | undefined;
 		envFile?: string | undefined;
 		environment?: string | undefined;
 	} | {
@@ -1994,6 +2033,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		};
 		srv: boolean;
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
+		timeout?: number | undefined;
 		authSource?: string | {
 			$env: string;
 		} | undefined;
@@ -2024,6 +2064,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			$env: string;
 		};
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
+		timeout?: number | undefined;
 		envFile?: string | undefined;
 		environment?: string | undefined;
 	} | {
@@ -2046,6 +2087,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		rejectUnauthorized: boolean;
 		protocol: "http" | "https";
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
+		timeout?: number | undefined;
 		nodes?: string[] | undefined;
 		cloudId?: string | {
 			$env: string;
@@ -2070,6 +2112,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		database: string | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2078,6 +2121,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "mongodb";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2115,6 +2159,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		port: number | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2129,6 +2174,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "elasticsearch";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2272,6 +2318,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			$env: string;
 		};
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
+		timeout?: number | undefined;
 		envFile?: string | undefined;
 		environment?: string | undefined;
 	} | {
@@ -2293,6 +2340,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		};
 		srv: boolean;
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
+		timeout?: number | undefined;
 		authSource?: string | {
 			$env: string;
 		} | undefined;
@@ -2323,6 +2371,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			$env: string;
 		};
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
+		timeout?: number | undefined;
 		envFile?: string | undefined;
 		environment?: string | undefined;
 	} | {
@@ -2345,6 +2394,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		rejectUnauthorized: boolean;
 		protocol: "http" | "https";
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
+		timeout?: number | undefined;
 		nodes?: string[] | undefined;
 		cloudId?: string | {
 			$env: string;
@@ -2380,6 +2430,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		database: string | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2388,6 +2439,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "mongodb";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2425,6 +2477,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		port: number | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2439,6 +2492,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "elasticsearch";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2532,6 +2586,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			$env: string;
 		};
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
+		timeout?: number | undefined;
 		envFile?: string | undefined;
 		environment?: string | undefined;
 	} | {
@@ -2553,6 +2608,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		};
 		srv: boolean;
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
+		timeout?: number | undefined;
 		authSource?: string | {
 			$env: string;
 		} | undefined;
@@ -2583,6 +2639,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			$env: string;
 		};
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
+		timeout?: number | undefined;
 		envFile?: string | undefined;
 		environment?: string | undefined;
 	} | {
@@ -2605,6 +2662,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		rejectUnauthorized: boolean;
 		protocol: "http" | "https";
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
+		timeout?: number | undefined;
 		nodes?: string[] | undefined;
 		cloudId?: string | {
 			$env: string;
@@ -2640,6 +2698,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		database: string | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2648,6 +2707,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "mongodb";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2685,6 +2745,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		port: number | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2699,6 +2760,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "elasticsearch";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2777,7 +2839,18 @@ export declare class QueryExecutor {
 		connectionName?: string;
 		recovery?: boolean;
 		deferDiagnostics?: boolean;
+		/**
+		 * Quoting rules that decide what counts as a statement separator differ
+		 * per dialect. Without this, the stacking check has to fail closed.
+		 */
+		dialect?: SqlDialect;
 	});
+	/**
+	 * The dialect the statement will actually run under. Falls back to the
+	 * connection config, then to undefined — where the stacking check fails
+	 * closed rather than guessing.
+	 */
+	private resolveDialect;
 	takeDiagnostics(): string[];
 	/**
 	 * Execute a SQL query with permission enforcement and error handling