@carllee1983/dbcli 1.46.0 → 1.47.0

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;
 }
 /**
@@ -668,6 +668,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 +741,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			database: string | {
 				$env: string;
 			};
+			timeout?: number | undefined;
 		}, {
 			user: string | {
 				$env: string;
@@ -754,11 +756,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 +864,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 				$env: string;
 			};
 			srv: boolean;
+			timeout?: number | undefined;
 			authSource?: string | {
 				$env: string;
 			} | undefined;
@@ -872,6 +877,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			} | undefined;
 		}, {
 			system: "mongodb";
+			timeout?: number | undefined;
 			password?: string | {
 				$env: string;
 			} | undefined;
@@ -900,6 +906,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 +975,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			database: string | {
 				$env: string;
 			};
+			timeout?: number | undefined;
 		}, {
 			system: "redis";
 			host: string | {
@@ -976,6 +984,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			port: number | {
 				$env: string;
 			};
+			timeout?: number | undefined;
 			password?: string | {
 				$env: string;
 			} | undefined;
@@ -987,6 +996,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 +1094,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			};
 			rejectUnauthorized: boolean;
 			protocol: "http" | "https";
+			timeout?: number | undefined;
 			nodes?: string[] | undefined;
 			cloudId?: string | {
 				$env: string;
@@ -1094,6 +1105,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			caPath?: string | undefined;
 		}, {
 			system: "elasticsearch";
+			timeout?: number | undefined;
 			password?: string | {
 				$env: string;
 			} | undefined;
@@ -1238,6 +1250,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			$env: string;
 		};
 		srv: boolean;
+		timeout?: number | undefined;
 		authSource?: string | {
 			$env: string;
 		} | undefined;
@@ -1265,6 +1278,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		database: string | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 	} | {
 		password: string | {
 			$env: string;
@@ -1282,6 +1296,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		database: string | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 	} | {
 		password: string | {
 			$env: string;
@@ -1301,6 +1316,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		};
 		rejectUnauthorized: boolean;
 		protocol: "http" | "https";
+		timeout?: number | undefined;
 		nodes?: string[] | undefined;
 		cloudId?: string | {
 			$env: string;
@@ -1320,6 +1336,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 }, {
 	connection: {
 		system: "mongodb";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -1360,6 +1377,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		database: string | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -1371,6 +1389,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		port: number | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -1382,6 +1401,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		} | undefined;
 	} | {
 		system: "elasticsearch";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -1443,6 +1463,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 +1546,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 +1563,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			database: string | {
 				$env: string;
 			};
+			timeout?: number | undefined;
 			password?: string | {
 				$env: string;
 			} | undefined;
@@ -1549,6 +1572,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 +1684,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 +1699,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			environment?: string | undefined;
 		}, {
 			system: "mongodb";
+			timeout?: number | undefined;
 			password?: string | {
 				$env: string;
 			} | undefined;
@@ -1705,6 +1731,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 +1810,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 +1821,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			port: number | {
 				$env: string;
 			};
+			timeout?: number | undefined;
 			password?: string | {
 				$env: string;
 			} | undefined;
@@ -1807,6 +1836,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 +1944,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 +1957,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			environment?: string | undefined;
 		}, {
 			system: "elasticsearch";
+			timeout?: number | undefined;
 			password?: string | {
 				$env: string;
 			} | undefined;
@@ -1973,6 +2005,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 +2027,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 +2058,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 +2081,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 +2106,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		database: string | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2078,6 +2115,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "mongodb";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2115,6 +2153,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		port: number | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2129,6 +2168,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "elasticsearch";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2272,6 +2312,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 +2334,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 +2365,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 +2388,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 +2424,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		database: string | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2388,6 +2433,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "mongodb";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2425,6 +2471,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		port: number | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2439,6 +2486,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "elasticsearch";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2532,6 +2580,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 +2602,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 +2633,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 +2656,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 +2692,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		database: string | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2648,6 +2701,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "mongodb";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2685,6 +2739,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		port: number | {
 			$env: string;
 		};
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;
@@ -2699,6 +2754,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "elasticsearch";
+		timeout?: number | undefined;
 		password?: string | {
 			$env: string;
 		} | undefined;

package/dist/core.mjs

@@ -16725,9 +16725,22 @@ class ElasticsearchAdapter {
   }
 }
 
+// src/utils/connection-timeout.ts
+var _globalConnectionTimeout;
+function resolveConnectionTimeout(configured) {
+  return _globalConnectionTimeout ?? configured;
+}
+function withResolvedTimeout(options) {
+  const timeout = resolveConnectionTimeout(options.timeout);
+  if (timeout === options.timeout)
+    return options;
+  return { ...options, timeout };
+}
+
 // src/adapters/factory.ts
 class AdapterFactory {
-  static createSqlAdapter(options) {
+  static createSqlAdapter(rawOptions) {
+    const options = withResolvedTimeout(rawOptions);
     switch (options.system) {
       case "postgresql":
         return new PostgreSQLAdapter(options);
@@ -16738,7 +16751,8 @@ class AdapterFactory {
         throw new Error(`createSqlAdapter requires a SQL system, got: ${options.system}`);
     }
   }
-  static createQueryableAdapter(options) {
+  static createQueryableAdapter(rawOptions) {
+    const options = withResolvedTimeout(rawOptions);
     switch (options.system) {
       case "mongodb":
         return new MongoDBAdapter(options);
@@ -16770,10 +16784,11 @@ class AdapterFactory {
     }
     return AdapterFactory.createQueryableAdapter(options);
   }
-  static createRedisAdapter(options, blacklistRules = [], maskRules = []) {
-    if (options.system !== "redis") {
+  static createRedisAdapter(rawOptions, blacklistRules = [], maskRules = []) {
+    if (rawOptions.system !== "redis") {
       throw new Error("createRedisAdapter requires system: redis");
     }
+    const options = withResolvedTimeout(rawOptions);
     const adapter = new RedisAdapter(options);
     adapter.setBlacklistRules(blacklistRules);
     adapter.setMaskRules(maskRules);
@@ -21851,6 +21866,11 @@ var StringOrEnvRef = exports_external.union([exports_external.string().min(1), E
 var NumberOrEnvRef = exports_external.union([exports_external.number().int().min(1).max(65535), EnvRefSchema]);
 var OptStringOrEnvRef = exports_external.union([exports_external.string(), EnvRefSchema]).optional().default("");
 var OptNumberOrEnvRef = exports_external.union([exports_external.number().int(), EnvRefSchema]).optional().default(27017);
+var MIN_CONNECTION_TIMEOUT_MS = 100;
+var MAX_CONNECTION_TIMEOUT_MS = 600000;
+var TimeoutField = {
+  timeout: exports_external.number().int().min(MIN_CONNECTION_TIMEOUT_MS).max(MAX_CONNECTION_TIMEOUT_MS).optional()
+};
 var MongoDBConnectionConfigSchema = exports_external.object({
   system: exports_external.literal("mongodb"),
   uri: exports_external.union([exports_external.string(), EnvRefSchema]).optional(),
@@ -21862,7 +21882,8 @@ var MongoDBConnectionConfigSchema = exports_external.object({
   authSource: exports_external.union([exports_external.string(), EnvRefSchema]).optional(),
   replicaSet: exports_external.union([exports_external.string(), EnvRefSchema]).optional(),
   tls: exports_external.boolean().optional(),
-  srv: exports_external.boolean().optional().default(false)
+  srv: exports_external.boolean().optional().default(false),
+  ...TimeoutField
 });
 var SqlConnectionConfigSchema = exports_external.object({
   system: exports_external.enum(["postgresql", "mysql", "mariadb"]),
@@ -21870,7 +21891,8 @@ var SqlConnectionConfigSchema = exports_external.object({
   port: NumberOrEnvRef,
   user: StringOrEnvRef,
   password: exports_external.union([exports_external.string(), EnvRefSchema]).default(""),
-  database: StringOrEnvRef
+  database: StringOrEnvRef,
+  ...TimeoutField
 });
 var RedisConnectionConfigSchema = exports_external.object({
   system: exports_external.literal("redis"),
@@ -21878,7 +21900,8 @@ var RedisConnectionConfigSchema = exports_external.object({
   port: NumberOrEnvRef,
   user: OptStringOrEnvRef,
   password: exports_external.union([exports_external.string(), EnvRefSchema]).optional().default(""),
-  database: OptStringOrEnvRef
+  database: OptStringOrEnvRef,
+  ...TimeoutField
 });
 var ElasticsearchConnectionConfigSchema = exports_external.object({
   system: exports_external.literal("elasticsearch"),
@@ -21892,7 +21915,8 @@ var ElasticsearchConnectionConfigSchema = exports_external.object({
   cloudId: exports_external.union([exports_external.string(), EnvRefSchema]).optional(),
   apiKey: exports_external.union([exports_external.string(), EnvRefSchema]).optional(),
   caPath: exports_external.string().optional(),
-  rejectUnauthorized: exports_external.boolean().optional().default(true)
+  rejectUnauthorized: exports_external.boolean().optional().default(true),
+  ...TimeoutField
 });
 var ConnectionConfigSchema = exports_external.union([
   SqlConnectionConfigSchema,
@@ -21982,6 +22006,89 @@ var DbcliConfigV2Schema = exports_external.object({
   path: ["default"]
 });
 
+// src/utils/config-error-format.ts
+var SUPPORTED_SYSTEMS = [
+  "postgresql",
+  "mysql",
+  "mariadb",
+  "mongodb",
+  "redis",
+  "elasticsearch"
+];
+function isConnectionNode(raw, path) {
+  const last = path[path.length - 1];
+  const parent = path[path.length - 2];
+  if (last !== "connection" && parent !== "connections")
+    return false;
+  const node = valueAtPath(raw, path);
+  return typeof node === "object" && node !== null && !Array.isArray(node);
+}
+function valueAtPath(raw, path) {
+  let current = raw;
+  for (const key of path) {
+    if (current == null || typeof current !== "object")
+      return;
+    current = current[key];
+  }
+  return current;
+}
+function declaredSystem(raw, path) {
+  const node = valueAtPath(raw, path);
+  if (node == null || typeof node !== "object")
+    return;
+  const system = node.system;
+  return typeof system === "string" ? system : undefined;
+}
+function branchMatchesSystem(issues) {
+  return !issues.some((issue) => issue.path[issue.path.length - 1] === "system" && (issue.code === "invalid_literal" || issue.code === "invalid_enum_value" || issue.code === "invalid_type"));
+}
+function formatPath(path) {
+  return path.length > 0 ? path.join(".") : "(root)";
+}
+function flattenIssues(issues, raw, basePath = []) {
+  const flat = [];
+  for (const issue of issues) {
+    const fullPath = [...basePath, ...issue.path];
+    if (issue.code === "invalid_union") {
+      const system = declaredSystem(raw, fullPath);
+      const branches = issue.unionErrors.map((error) => error.issues);
+      const candidates = system ? branches.filter((branchIssues) => branchMatchesSystem(branchIssues)) : [];
+      if (isConnectionNode(raw, fullPath) && candidates.length === 0) {
+        flat.push({
+          path: formatPath([...fullPath, "system"]),
+          message: `must be one of ${SUPPORTED_SYSTEMS.join(" | ")}` + (system === undefined ? " (missing)" : ` (received '${system}')`)
+        });
+        continue;
+      }
+      const chosen = candidates[0] ?? branches.reduce((best, current) => current.length < best.length ? current : best, branches[0] ?? []);
+      flat.push(...flattenIssues(chosen, raw, basePath));
+      continue;
+    }
+    flat.push({ path: formatPath(fullPath), message: issue.message });
+  }
+  return flat;
+}
+function dedupe(issues) {
+  const seen = new Set;
+  return issues.filter((issue) => {
+    const key = `${issue.path}\x00${issue.message}`;
+    if (seen.has(key))
+      return false;
+    seen.add(key);
+    return true;
+  });
+}
+function formatConfigValidationError(error, raw) {
+  const issues = dedupe(flattenIssues(error.issues, raw));
+  if (issues.length === 0)
+    return error.message;
+  return issues.map((issue) => `  - ${issue.path}: ${issue.message}`).join(`
+`);
+}
+function isZodError(error) {
+  return error instanceof Error && error.name === "ZodError" && Array.isArray(error.issues);
+}
+
 // src/agent-core/env-loader.ts
 import { readFile as readFile3 } from "fs/promises";
 function parseEnvContent(content) {
@@ -22188,6 +22295,7 @@ function parseEnvPassword(content) {
 var configModule = {
   async read(path, connectionName, options = {}) {
     const effectiveConnectionName = connectionName ?? _globalConnectionName;
+    let rawForDiagnostics;
     try {
       const binding = await readProjectBinding(path);
       const storagePath = await resolveConfigStoragePath(path);
@@ -22213,6 +22321,7 @@ var configModule = {
           const content = await configFile.text();
           await assertConfigIntegrity(storagePath, content, { requireRecord: true });
           const config = JSON.parse(content);
+          rawForDiagnostics = config;
           if (detectConfigVersion(config) === 2) {
             const v2Config = DbcliConfigV2Schema.parse(config);
             const resolved = resolveConnection(v2Config, effectiveConnectionName);
@@ -22293,6 +22402,7 @@ var configModule = {
         assertNoConnectionSelectorOnV1(effectiveConnectionName);
         const content = await file.text();
         const raw = JSON.parse(content);
+        rawForDiagnostics = raw;
         const resolved = resolveEnvReferences(raw, process.env);
         return DbcliConfigSchema.parse(resolved);
       }
@@ -22303,6 +22413,10 @@ var configModule = {
     } catch (error) {
       if (error instanceof ConfigError)
         throw error;
+      if (isZodError(error)) {
+        throw new ConfigError(`Failed to read .dbcli config: \u8A2D\u5B9A\u5167\u5BB9\u4E0D\u7B26\u5408\u7D50\u69CB
+${formatConfigValidationError(error, rawForDiagnostics)}`);
+      }
       if (error instanceof Error && error.message.includes("JSON")) {
         throw new ConfigError(`Failed to parse .dbcli file: ${error.message}`);
       }
@@ -22313,6 +22427,10 @@ var configModule = {
     try {
       return DbcliConfigSchema.parse(raw);
     } catch (error) {
+      if (isZodError(error)) {
+        throw new ConfigError(`Invalid .dbcli config structure:
+${formatConfigValidationError(error, raw)}`);
+      }
       const errorMessage = error instanceof Error ? error.message : String(error);
       throw new ConfigError(`Invalid .dbcli config structure: ${errorMessage}`);
     }
@@ -22413,6 +22531,7 @@ var KEEP_VALUE_FLAGS = new Set([
   "--min-severity",
   "--output",
   "--limit",
+  "--timeout",
   "--collection",
   "--index",
   "--fields",

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "dbcli-agent",
-  "version": "1.46.0",
+  "version": "1.47.0",
   "description": "Database CLI skill and command reference for AI agents.",
   "contextFileName": "AGENTS.md"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carllee1983/dbcli",
-  "version": "1.46.0",
+  "version": "1.47.0",
   "description": "Database CLI for AI agents",
   "type": "module",
   "publishConfig": {