@carllee1983/dbcli 1.56.0 → 1.57.0

package/dist/core.d.ts

@@ -843,6 +843,9 @@ declare const DbcliConfigSchema: z.ZodObject<{
 				}>
 			]>;
 		}, "strip", z.ZodTypeAny, {
+			password: string | {
+				$env: string;
+			};
 			system: "postgresql" | "mysql" | "mariadb";
 			host: string | {
 				$env: string;
@@ -853,9 +856,6 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			user: string | {
 				$env: string;
 			};
-			password: string | {
-				$env: string;
-			};
 			database: string | {
 				$env: string;
 			};
@@ -968,6 +968,9 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			tls: z.ZodOptional<z.ZodBoolean>;
 			srv: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 		}, "strip", z.ZodTypeAny, {
+			password: string | {
+				$env: string;
+			};
 			system: "mongodb";
 			host: string | {
 				$env: string;
@@ -978,9 +981,6 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			user: string | {
 				$env: string;
 			};
-			password: string | {
-				$env: string;
-			};
 			database: string | {
 				$env: string;
 			};
@@ -999,6 +999,9 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			statementTimeout?: number | undefined;
 		}, {
 			system: "mongodb";
+			password?: string | {
+				$env: string;
+			} | undefined;
 			host?: string | {
 				$env: string;
 			} | undefined;
@@ -1008,9 +1011,6 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			user?: string | {
 				$env: string;
 			} | undefined;
-			password?: string | {
-				$env: string;
-			} | undefined;
 			database?: string | {
 				$env: string;
 			} | undefined;
@@ -1083,6 +1083,9 @@ declare const DbcliConfigSchema: z.ZodObject<{
 				}>
 			]>>>;
 		}, "strip", z.ZodTypeAny, {
+			password: string | {
+				$env: string;
+			};
 			system: "redis";
 			host: string | {
 				$env: string;
@@ -1093,9 +1096,6 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			user: string | {
 				$env: string;
 			};
-			password: string | {
-				$env: string;
-			};
 			database: string | {
 				$env: string;
 			};
@@ -1109,10 +1109,10 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			port: number | {
 				$env: string;
 			};
-			user?: string | {
+			password?: string | {
 				$env: string;
 			} | undefined;
-			password?: string | {
+			user?: string | {
 				$env: string;
 			} | undefined;
 			database?: string | {
@@ -1203,6 +1203,9 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			caPath: z.ZodOptional<z.ZodString>;
 			rejectUnauthorized: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 		}, "strip", z.ZodTypeAny, {
+			password: string | {
+				$env: string;
+			};
 			system: "elasticsearch";
 			host: string | {
 				$env: string;
@@ -1213,9 +1216,6 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			user: string | {
 				$env: string;
 			};
-			password: string | {
-				$env: string;
-			};
 			database: string | {
 				$env: string;
 			};
@@ -1233,6 +1233,9 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			caPath?: string | undefined;
 		}, {
 			system: "elasticsearch";
+			password?: string | {
+				$env: string;
+			} | undefined;
 			host?: string | {
 				$env: string;
 			} | undefined;
@@ -1242,9 +1245,6 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			user?: string | {
 				$env: string;
 			} | undefined;
-			password?: string | {
-				$env: string;
-			} | undefined;
 			database?: string | {
 				$env: string;
 			} | undefined;
@@ -1356,6 +1356,9 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		};
 	};
 	connection: {
+		password: string | {
+			$env: string;
+		};
 		system: "mongodb";
 		host: string | {
 			$env: string;
@@ -1366,9 +1369,6 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
@@ -1386,6 +1386,9 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		timeout?: number | undefined;
 		statementTimeout?: number | undefined;
 	} | {
+		password: string | {
+			$env: string;
+		};
 		system: "postgresql" | "mysql" | "mariadb";
 		host: string | {
 			$env: string;
@@ -1396,15 +1399,15 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
 		timeout?: number | undefined;
 		statementTimeout?: number | undefined;
 	} | {
+		password: string | {
+			$env: string;
+		};
 		system: "redis";
 		host: string | {
 			$env: string;
@@ -1415,15 +1418,15 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
 		timeout?: number | undefined;
 		statementTimeout?: number | undefined;
 	} | {
+		password: string | {
+			$env: string;
+		};
 		system: "elasticsearch";
 		host: string | {
 			$env: string;
@@ -1434,9 +1437,6 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
@@ -1469,6 +1469,9 @@ declare const DbcliConfigSchema: z.ZodObject<{
 }, {
 	connection: {
 		system: "mongodb";
+		password?: string | {
+			$env: string;
+		} | undefined;
 		host?: string | {
 			$env: string;
 		} | undefined;
@@ -1478,9 +1481,6 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		user?: string | {
 			$env: string;
 		} | undefined;
-		password?: string | {
-			$env: string;
-		} | undefined;
 		database?: string | {
 			$env: string;
 		} | undefined;
@@ -1524,10 +1524,10 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		port: number | {
 			$env: string;
 		};
-		user?: string | {
+		password?: string | {
 			$env: string;
 		} | undefined;
-		password?: string | {
+		user?: string | {
 			$env: string;
 		} | undefined;
 		database?: string | {
@@ -1537,6 +1537,9 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		statementTimeout?: number | undefined;
 	} | {
 		system: "elasticsearch";
+		password?: string | {
+			$env: string;
+		} | undefined;
 		host?: string | {
 			$env: string;
 		} | undefined;
@@ -1546,9 +1549,6 @@ declare const DbcliConfigSchema: z.ZodObject<{
 		user?: string | {
 			$env: string;
 		} | undefined;
-		password?: string | {
-			$env: string;
-		} | undefined;
 		database?: string | {
 			$env: string;
 		} | undefined;
@@ -1667,6 +1667,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			envFile: z.ZodOptional<z.ZodString>;
 			environment: z.ZodOptional<z.ZodEffects<z.ZodString, string | undefined, string>>;
 		}, "strip", z.ZodTypeAny, {
+			password: string | {
+				$env: string;
+			};
 			system: "postgresql" | "mysql" | "mariadb";
 			host: string | {
 				$env: string;
@@ -1677,9 +1680,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			user: string | {
 				$env: string;
 			};
-			password: string | {
-				$env: string;
-			};
 			database: string | {
 				$env: string;
 			};
@@ -1807,6 +1807,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			envFile: z.ZodOptional<z.ZodString>;
 			environment: z.ZodOptional<z.ZodEffects<z.ZodString, string | undefined, string>>;
 		}, "strip", z.ZodTypeAny, {
+			password: string | {
+				$env: string;
+			};
 			system: "mongodb";
 			host: string | {
 				$env: string;
@@ -1817,9 +1820,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			user: string | {
 				$env: string;
 			};
-			password: string | {
-				$env: string;
-			};
 			database: string | {
 				$env: string;
 			};
@@ -1841,6 +1841,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			environment?: string | undefined;
 		}, {
 			system: "mongodb";
+			password?: string | {
+				$env: string;
+			} | undefined;
 			host?: string | {
 				$env: string;
 			} | undefined;
@@ -1850,9 +1853,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			user?: string | {
 				$env: string;
 			} | undefined;
-			password?: string | {
-				$env: string;
-			} | undefined;
 			database?: string | {
 				$env: string;
 			} | undefined;
@@ -1937,6 +1937,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			envFile: z.ZodOptional<z.ZodString>;
 			environment: z.ZodOptional<z.ZodEffects<z.ZodString, string | undefined, string>>;
 		}, "strip", z.ZodTypeAny, {
+			password: string | {
+				$env: string;
+			};
 			system: "redis";
 			host: string | {
 				$env: string;
@@ -1947,9 +1950,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			user: string | {
 				$env: string;
 			};
-			password: string | {
-				$env: string;
-			};
 			database: string | {
 				$env: string;
 			};
@@ -1966,10 +1966,10 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			port: number | {
 				$env: string;
 			};
-			user?: string | {
+			password?: string | {
 				$env: string;
 			} | undefined;
-			password?: string | {
+			user?: string | {
 				$env: string;
 			} | undefined;
 			database?: string | {
@@ -2072,6 +2072,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			envFile: z.ZodOptional<z.ZodString>;
 			environment: z.ZodOptional<z.ZodEffects<z.ZodString, string | undefined, string>>;
 		}, "strip", z.ZodTypeAny, {
+			password: string | {
+				$env: string;
+			};
 			system: "elasticsearch";
 			host: string | {
 				$env: string;
@@ -2082,9 +2085,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			user: string | {
 				$env: string;
 			};
-			password: string | {
-				$env: string;
-			};
 			database: string | {
 				$env: string;
 			};
@@ -2105,6 +2105,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			environment?: string | undefined;
 		}, {
 			system: "elasticsearch";
+			password?: string | {
+				$env: string;
+			} | undefined;
 			host?: string | {
 				$env: string;
 			} | undefined;
@@ -2114,9 +2117,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			user?: string | {
 				$env: string;
 			} | undefined;
-			password?: string | {
-				$env: string;
-			} | undefined;
 			database?: string | {
 				$env: string;
 			} | undefined;
@@ -2137,6 +2137,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			environment?: string | undefined;
 		}>
 	]>>, Record<string, {
+		password: string | {
+			$env: string;
+		};
 		system: "postgresql" | "mysql" | "mariadb";
 		host: string | {
 			$env: string;
@@ -2147,9 +2150,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
@@ -2159,6 +2159,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		envFile?: string | undefined;
 		environment?: string | undefined;
 	} | {
+		password: string | {
+			$env: string;
+		};
 		system: "mongodb";
 		host: string | {
 			$env: string;
@@ -2169,9 +2172,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
@@ -2192,6 +2192,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		envFile?: string | undefined;
 		environment?: string | undefined;
 	} | {
+		password: string | {
+			$env: string;
+		};
 		system: "redis";
 		host: string | {
 			$env: string;
@@ -2202,9 +2205,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
@@ -2214,6 +2214,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		envFile?: string | undefined;
 		environment?: string | undefined;
 	} | {
+		password: string | {
+			$env: string;
+		};
 		system: "elasticsearch";
 		host: string | {
 			$env: string;
@@ -2224,9 +2227,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
@@ -2269,6 +2269,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "mongodb";
+		password?: string | {
+			$env: string;
+		} | undefined;
 		host?: string | {
 			$env: string;
 		} | undefined;
@@ -2278,9 +2281,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user?: string | {
 			$env: string;
 		} | undefined;
-		password?: string | {
-			$env: string;
-		} | undefined;
 		database?: string | {
 			$env: string;
 		} | undefined;
@@ -2308,10 +2308,10 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		port: number | {
 			$env: string;
 		};
-		user?: string | {
+		password?: string | {
 			$env: string;
 		} | undefined;
-		password?: string | {
+		user?: string | {
 			$env: string;
 		} | undefined;
 		database?: string | {
@@ -2324,6 +2324,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "elasticsearch";
+		password?: string | {
+			$env: string;
+		} | undefined;
 		host?: string | {
 			$env: string;
 		} | undefined;
@@ -2333,9 +2336,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user?: string | {
 			$env: string;
 		} | undefined;
-		password?: string | {
-			$env: string;
-		} | undefined;
 		database?: string | {
 			$env: string;
 		} | undefined;
@@ -2452,6 +2452,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		schemaTableCount?: number | undefined;
 	};
 	connections: Record<string, {
+		password: string | {
+			$env: string;
+		};
 		system: "postgresql" | "mysql" | "mariadb";
 		host: string | {
 			$env: string;
@@ -2462,9 +2465,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
@@ -2474,6 +2474,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		envFile?: string | undefined;
 		environment?: string | undefined;
 	} | {
+		password: string | {
+			$env: string;
+		};
 		system: "mongodb";
 		host: string | {
 			$env: string;
@@ -2484,9 +2487,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
@@ -2507,6 +2507,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		envFile?: string | undefined;
 		environment?: string | undefined;
 	} | {
+		password: string | {
+			$env: string;
+		};
 		system: "redis";
 		host: string | {
 			$env: string;
@@ -2517,9 +2520,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
@@ -2529,6 +2529,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		envFile?: string | undefined;
 		environment?: string | undefined;
 	} | {
+		password: string | {
+			$env: string;
+		};
 		system: "elasticsearch";
 		host: string | {
 			$env: string;
@@ -2539,9 +2542,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
@@ -2595,6 +2595,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "mongodb";
+		password?: string | {
+			$env: string;
+		} | undefined;
 		host?: string | {
 			$env: string;
 		} | undefined;
@@ -2604,9 +2607,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user?: string | {
 			$env: string;
 		} | undefined;
-		password?: string | {
-			$env: string;
-		} | undefined;
 		database?: string | {
 			$env: string;
 		} | undefined;
@@ -2634,10 +2634,10 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		port: number | {
 			$env: string;
 		};
-		user?: string | {
+		password?: string | {
 			$env: string;
 		} | undefined;
-		password?: string | {
+		user?: string | {
 			$env: string;
 		} | undefined;
 		database?: string | {
@@ -2650,6 +2650,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "elasticsearch";
+		password?: string | {
+			$env: string;
+		} | undefined;
 		host?: string | {
 			$env: string;
 		} | undefined;
@@ -2659,9 +2662,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user?: string | {
 			$env: string;
 		} | undefined;
-		password?: string | {
-			$env: string;
-		} | undefined;
 		database?: string | {
 			$env: string;
 		} | undefined;
@@ -2728,6 +2728,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		schemaTableCount?: number | undefined;
 	};
 	connections: Record<string, {
+		password: string | {
+			$env: string;
+		};
 		system: "postgresql" | "mysql" | "mariadb";
 		host: string | {
 			$env: string;
@@ -2738,9 +2741,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
@@ -2750,6 +2750,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		envFile?: string | undefined;
 		environment?: string | undefined;
 	} | {
+		password: string | {
+			$env: string;
+		};
 		system: "mongodb";
 		host: string | {
 			$env: string;
@@ -2760,9 +2763,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
@@ -2783,6 +2783,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		envFile?: string | undefined;
 		environment?: string | undefined;
 	} | {
+		password: string | {
+			$env: string;
+		};
 		system: "redis";
 		host: string | {
 			$env: string;
@@ -2793,9 +2796,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
@@ -2805,6 +2805,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		envFile?: string | undefined;
 		environment?: string | undefined;
 	} | {
+		password: string | {
+			$env: string;
+		};
 		system: "elasticsearch";
 		host: string | {
 			$env: string;
@@ -2815,9 +2818,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user: string | {
 			$env: string;
 		};
-		password: string | {
-			$env: string;
-		};
 		database: string | {
 			$env: string;
 		};
@@ -2871,6 +2871,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "mongodb";
+		password?: string | {
+			$env: string;
+		} | undefined;
 		host?: string | {
 			$env: string;
 		} | undefined;
@@ -2880,9 +2883,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user?: string | {
 			$env: string;
 		} | undefined;
-		password?: string | {
-			$env: string;
-		} | undefined;
 		database?: string | {
 			$env: string;
 		} | undefined;
@@ -2910,10 +2910,10 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		port: number | {
 			$env: string;
 		};
-		user?: string | {
+		password?: string | {
 			$env: string;
 		} | undefined;
-		password?: string | {
+		user?: string | {
 			$env: string;
 		} | undefined;
 		database?: string | {
@@ -2926,6 +2926,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		environment?: string | undefined;
 	} | {
 		system: "elasticsearch";
+		password?: string | {
+			$env: string;
+		} | undefined;
 		host?: string | {
 			$env: string;
 		} | undefined;
@@ -2935,9 +2938,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		user?: string | {
 			$env: string;
 		} | undefined;
-		password?: string | {
-			$env: string;
-		} | undefined;
 		database?: string | {
 			$env: string;
 		} | undefined;
@@ -3372,8 +3372,6 @@ export type SqlSystem = "postgresql" | "mysql" | "mariadb";
  * 且 loadEnvFile 不覆寫既有 key——若兩連線都用 DB_PASSWORD 會撞名取到對方的值。
  */
 export declare function envVarNameFor(connName: string, field: "password"): string;
-/** 把 secret 寫進該連線的 envFile(KEY=VALUE);既有同名 key 就地覆寫,否則追加。 */
-export declare function writeConnectionSecret(projectPath: string, connName: string, field: "password", value: string): Promise<void>;
 export interface ConnectionInput {
 	name: string;
 	system: SqlSystem;
@@ -3395,6 +3393,30 @@ export declare function migrateV1ToV2(v1: DbcliConfig$1): DbcliConfigV2;
 /** 新增或就地覆寫同名連線(immutable)。非機密欄存字面值,password 存 {$env} 參照 +
  *  per-connection envFile。編輯時保留既有 permission;新建預設 'query-only'。 */
 export declare function upsertConnection(config: DbcliConfigV2, input: ConnectionInput): DbcliConfigV2;
+/**
+ * 單一連線的密碼輪替：只動該連線的密碼，其餘設定原封不動。
+ *
+ * 密碼實際落在哪裡由 config 決定，不是靠命名規則猜的——
+ * 連線若已用 `{ $env: NAME }`，就改寫 NAME 這個 key；若還是明文，
+ * 先把 config 轉成 env 參照再寫檔，之後的輪替就不必再碰 config.json。
+ */
+export interface PasswordTarget {
+	/** 被更新的連線名稱 */
+	connection: string;
+	/** 密碼寫入的 env 檔（相對於 config storage 目錄） */
+	envFile: string;
+	/** 寫入的環境變數名稱 */
+	varName: string;
+	/** 這次是否需要把 config 裡的明文密碼轉成 $env 參照 */
+	convertedToEnvRef: boolean;
+}
+/**
+ * 查出「這條連線的密碼該寫到哪個 env 檔的哪個 key」，不寫入任何檔案。
+ *
+ * 驗證新密碼時得先知道 key 名稱才能注入，所以查詢與寫入分開。
+ */
+export declare function resolvePasswordTarget(projectPath: string, connectionName?: string): Promise<PasswordTarget>;
+export declare function setConnectionPassword(projectPath: string, connectionName: string | undefined, password: string): Promise<PasswordTarget>;
 /**
  * Resolve the per-user dbcli root lazily so embedders and tests can provide an
  * isolated config home without reloading the module. `DBCLI_CONFIG_HOME` is a