@carllee1983/dbcli 9.1.2 → 11.0.0

package/dist/cli.mjs

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@carllee1983/dbcli",
-  version: "9.1.2",
+  version: "11.0.0",
   description: "Database CLI for AI agents",
   type: "module",
   publishConfig: {
@@ -44,7 +44,7 @@ var package_default = {
     "blacklist"
   ],
   engines: {
-    bun: ">=1.3.3"
+    bun: ">=1.4.0"
   },
   files: [
     "dist/",
@@ -103,6 +103,7 @@ var package_default = {
     "lru-cache": "^11.4.0",
     "lucide-react": "^1.16.0",
     mongodb: "^7.2.0",
+    "mongodb-connection-string-url": "^7.0.1",
     mysql2: "^3.24.3",
     "node-sql-parser": "5",
     open: "^11.0.0",

package/dist/core.d.ts

@@ -36,6 +36,8 @@ export interface ConnectionOptions {
 	replicaSet?: string;
 	/** MongoDB TLS switch (optional, field-based config; implied true when srv) */
 	tls?: boolean;
+	/** MongoDB extra driver options appended to the URI query string (field-based config, plain strings only) */
+	options?: Record<string, string>;
 	/** MongoDB SRV lookup — build a mongodb+srv:// URI from host (optional, field-based config) */
 	srv?: boolean;
 	/** Connection timeout in milliseconds (default: 5000) */
@@ -440,6 +442,8 @@ interface MongoDBConnectionConfig {
 		$env: string;
 	};
 	tls?: boolean;
+	/** Extra driver options appended to the URI query string; plain strings, no env-ref */
+	options?: Record<string, string>;
 	/** Build a mongodb+srv:// URI from host and expand it via DNS SRV lookup */
 	srv?: boolean;
 }
@@ -1105,6 +1109,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 				}>
 			]>>;
 			tls: z.ZodOptional<z.ZodBoolean>;
+			options: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>>;
 			srv: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 		}, "strip", z.ZodTypeAny, {
 			password: string | {
@@ -1134,6 +1139,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 				$env: string;
 			} | undefined;
 			tls?: boolean | undefined;
+			options?: Record<string, string> | undefined;
 			timeout?: number | undefined;
 			statementTimeout?: number | undefined;
 		}, {
@@ -1163,6 +1169,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 				$env: string;
 			} | undefined;
 			tls?: boolean | undefined;
+			options?: Record<string, string> | undefined;
 			srv?: boolean | undefined;
 			timeout?: number | undefined;
 			statementTimeout?: number | undefined;
@@ -1569,6 +1576,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			$env: string;
 		} | undefined;
 		tls?: boolean | undefined;
+		options?: Record<string, string> | undefined;
 		timeout?: number | undefined;
 		statementTimeout?: number | undefined;
 	} | {
@@ -1701,6 +1709,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 			$env: string;
 		} | undefined;
 		tls?: boolean | undefined;
+		options?: Record<string, string> | undefined;
 		srv?: boolean | undefined;
 		timeout?: number | undefined;
 		statementTimeout?: number | undefined;
@@ -1827,7 +1836,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 type DbcliConfig$1 = z.infer<typeof DbcliConfigSchema>;
 declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 	version: z.ZodLiteral<2>;
-	default: z.ZodString;
+	default: z.ZodOptional<z.ZodString>;
 	connections: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodUnion<[
 		z.ZodObject<{
 			timeout: z.ZodOptional<z.ZodNumber>;
@@ -2154,6 +2163,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 				}>
 			]>>;
 			tls: z.ZodOptional<z.ZodBoolean>;
+			options: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>>;
 			srv: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 		} & {
 			permission: z.ZodDefault<z.ZodEnum<[
@@ -2193,6 +2203,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 				$env: string;
 			} | undefined;
 			tls?: boolean | undefined;
+			options?: Record<string, string> | undefined;
 			timeout?: number | undefined;
 			statementTimeout?: number | undefined;
 			envFile?: string | undefined;
@@ -2224,6 +2235,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 				$env: string;
 			} | undefined;
 			tls?: boolean | undefined;
+			options?: Record<string, string> | undefined;
 			srv?: boolean | undefined;
 			timeout?: number | undefined;
 			permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
@@ -2570,6 +2582,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			$env: string;
 		} | undefined;
 		tls?: boolean | undefined;
+		options?: Record<string, string> | undefined;
 		timeout?: number | undefined;
 		statementTimeout?: number | undefined;
 		envFile?: string | undefined;
@@ -2704,6 +2717,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			$env: string;
 		} | undefined;
 		tls?: boolean | undefined;
+		options?: Record<string, string> | undefined;
 		timeout?: number | undefined;
 		statementTimeout?: number | undefined;
 		envFile?: string | undefined;
@@ -2898,7 +2912,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		};
 	};
 	version: 2;
-	default: string;
 	metadata: {
 		version: string;
 		createdAt?: string | undefined;
@@ -2981,6 +2994,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			$env: string;
 		} | undefined;
 		tls?: boolean | undefined;
+		options?: Record<string, string> | undefined;
 		timeout?: number | undefined;
 		statementTimeout?: number | undefined;
 		envFile?: string | undefined;
@@ -3047,9 +3061,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			fields?: string[] | undefined;
 		}[];
 	} | undefined;
+	default?: string | undefined;
 }, {
 	version: 2;
-	default: string;
 	connections: Record<string, unknown>;
 	redis?: {
 		mask?: {
@@ -3070,6 +3084,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			max_entries?: number | undefined;
 		} | undefined;
 	} | undefined;
+	default?: string | undefined;
 	metadata?: {
 		version?: string | undefined;
 		createdAt?: string | undefined;
@@ -3092,7 +3107,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		};
 	};
 	version: 2;
-	default: string;
 	metadata: {
 		version: string;
 		createdAt?: string | undefined;
@@ -3175,6 +3189,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			$env: string;
 		} | undefined;
 		tls?: boolean | undefined;
+		options?: Record<string, string> | undefined;
 		timeout?: number | undefined;
 		statementTimeout?: number | undefined;
 		envFile?: string | undefined;
@@ -3241,9 +3256,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			fields?: string[] | undefined;
 		}[];
 	} | undefined;
+	default?: string | undefined;
 }, {
 	version: 2;
-	default: string;
 	connections: Record<string, unknown>;
 	redis?: {
 		mask?: {
@@ -3264,6 +3279,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			max_entries?: number | undefined;
 		} | undefined;
 	} | undefined;
+	default?: string | undefined;
 	metadata?: {
 		version?: string | undefined;
 		createdAt?: string | undefined;
@@ -3630,9 +3646,7 @@ export declare function resolveConnection(config: DbcliConfigV2, name: string |
  * Load env file for a connection if specified
  */
 export declare function loadConnectionEnv(resolved: ResolvedConnection, basePath: string): Promise<void>;
-/**
- * Read and validate a v2 config from disk
- */
+/** Read and validate a v2 config from disk. */
 export declare function readV2Config(path: string): Promise<DbcliConfigV2>;
 /**
  * Write a v2 config and its integrity records as one recoverable publication.
@@ -3675,7 +3689,7 @@ export interface ConnectionInput {
 	user: string;
 	database: string;
 }
-/** 刪除連線(immutable)。刪預設則改派為剩餘第一條;刪最後一條則擋下(v2 需至少一條)。 */
+/** 刪除連線(immutable)。刪預設則清空預設;刪最後一條則擋下(v2 需至少一條)。 */
 export declare function removeConnection(config: DbcliConfigV2, name: string): DbcliConfigV2;
 /** 設定預設連線(immutable)。 */
 export declare function setDefaultConnection(config: DbcliConfigV2, name: string): DbcliConfigV2;

package/dist/core.mjs

@@ -1251,6 +1251,8 @@ var messages_default = {
   init: {
     description: "Initialize dbcli configuration with .env parsing and interactive prompts",
     welcome: "Welcome to dbcli",
+    prompt_connection_name: "Connection name",
+    connection_name_required: "Connection name is required. Provide --conn-name <name> (this is separate from the database --name).",
     select_system: "Select database system:",
     prompt_host: "Database host: ",
     prompt_port: "Database port: ",
@@ -1259,6 +1261,22 @@ var messages_default = {
     secret_alternatives_sql: "pass --password, supply the credential through .env or the process environment, or store a reference with --use-env-refs",
     secret_alternatives_mongo_password: "pass --password, supply the credential through .env or the process environment, or paste the connection string with --uri",
     secret_alternatives_mongo_uri: "pass the connection string with --uri",
+    mongo_uri_conflicts_fields: "--uri cannot be combined with {flags}: the connection string already carries those settings. Use one or the other (--name may be combined to override the database name).",
+    mongo_uri_with_env_refs: "--uri cannot be combined with --use-env-refs: the connection string is decomposed into config fields, and its credentials are not moved into environment variables. Either remove --use-env-refs so dbcli decomposes the string into the field config, or use the --env-* flags (--env-host, --env-user, --env-password, ...) to name one variable per field.",
+    mongo_uri_fallback_warning: "\u26A0\uFE0F  This connection string {reasons}, so it cannot become fields. It is stored as-is in uri, and its credentials will sit in plaintext in the config file.",
+    mongo_uri_reason_multi_host: "contains more than one host (a field config holds only one)",
+    mongo_uri_reason_secret_option: "contains secret option(s) ({keys}) that would land in plaintext options",
+    mongo_uri_reason_duplicate_key: "repeats the query key(s) {keys} (a field config can hold only one value per key)",
+    mongo_uri_reason_non_scram: "uses the non-SCRAM auth mechanism {mechanism} (field config cannot express it)",
+    mongo_decomposed_header: "Connection string decomposed into these fields (password hidden):",
+    mongo_paste_env_refs_warning: "\u26A0\uFE0F  --use-env-refs does not apply to a pasted connection string: its credentials are written to the config file as they are, not as environment-variable references.",
+    mongo_setup_mode_paste: "Paste a connection string (copied from Atlas / Compass)",
+    mongo_string_invalid: "Not a valid MongoDB connection string (it is not echoed because it may carry credentials).",
+    mongo_string_bad_host: "The connection string has an invalid host or port (the port must be an integer from 1 to 65535).",
+    mongo_string_bad_credentials: "The connection string's credentials contain an unescaped reserved character such as @, : or /. Percent-encode it (for example @ as %40).",
+    mongo_string_tls_conflict: "The connection string sets tls and ssl to different values.",
+    mongo_string_bad_tls: "The connection string's {key} must be true or false.",
+    mongo_string_empty_option: "The connection string sets {key} but leaves it empty. Give it a value or remove it.",
     prompt_name: "Database name: ",
     prompt_permission: "Permission level (query-only, read-write, data-admin, admin): ",
     env_parse_note: "Note: Unable to parse .env configuration, using interactive prompts",
@@ -1275,7 +1293,7 @@ var messages_default = {
     config_exists_use_force: ".dbcli exists. Use --force option to overwrite.",
     connection_added: "Connection '{name}' added",
     connection_removed: "Connection '{name}' removed",
-    connection_removed_switched: "Connection '{name}' removed. Default connection switched to '{newDefault}'",
+    connection_removed_default_cleared: "Connection '{name}' removed. Default connection cleared. Specify --use <name> or DBCLI_CONNECTION for database commands.",
     connection_renamed: "Connection '{oldName}' renamed to '{newName}'",
     v1_migration_prompt: "Detected old config format. Create new format and import existing connection as 'default'?",
     config_saved_v2: "V2 configuration saved to .dbcli",
@@ -1313,6 +1331,9 @@ var messages_default = {
     description: "Switch or display the default database connection",
     switched: "Switched default connection to {name}",
     current: "Current default connection: {name}",
+    current_none: "No default connection. Specify --use <name> or DBCLI_CONNECTION.",
+    unset: "Default connection cleared. Specify --use <name> or DBCLI_CONNECTION for database commands.",
+    unset_conflict: "--unset cannot be combined with a connection name, --list, --confirm-production, or --format json",
     requires_v2: "This feature requires v2 config format. Use 'dbcli init --conn-name <name>' to create one",
     available: "Available connections"
   },
@@ -1583,6 +1604,8 @@ var messages_default2 = {
   init: {
     description: "\u521D\u59CB\u5316 dbcli \u914D\u7F6E\uFF0C\u89E3\u6790 .env \u4E26\u9032\u884C\u4E92\u52D5\u5F0F\u63D0\u793A",
     welcome: "\u6B61\u8FCE\u4F7F\u7528 dbcli",
+    prompt_connection_name: "\u9023\u7DDA\u540D\u7A31",
+    connection_name_required: "\u9023\u7DDA\u540D\u7A31\u4E0D\u53EF\u7A7A\u767D\uFF0C\u8ACB\u63D0\u4F9B --conn-name <name>\uFF08\u8207\u8CC7\u6599\u5EAB\u540D\u7A31 --name \u4E0D\u540C\uFF09\u3002",
     select_system: "\u9078\u64C7\u8CC7\u6599\u5EAB\u7CFB\u7D71\uFF1A",
     prompt_host: "\u8CC7\u6599\u5EAB\u4E3B\u6A5F\uFF1A",
     prompt_port: "\u8CC7\u6599\u5EAB\u57E0\u865F\uFF1A",
@@ -1591,6 +1614,22 @@ var messages_default2 = {
     secret_alternatives_sql: "\u6539\u7528 --password\u3001\u628A\u6191\u8B49\u653E\u9032 .env \u6216\u884C\u7A0B\u74B0\u5883\u8B8A\u6578\uFF0C\u6216\u4EE5 --use-env-refs \u5B58\u6210\u53C3\u7167",
     secret_alternatives_mongo_password: "\u6539\u7528 --password\u3001\u628A\u6191\u8B49\u653E\u9032 .env \u6216\u884C\u7A0B\u74B0\u5883\u8B8A\u6578\uFF0C\u6216\u4EE5 --uri \u8CBC\u4E0A\u9023\u7DDA\u5B57\u4E32",
     secret_alternatives_mongo_uri: "\u4EE5 --uri \u50B3\u5165\u9023\u7DDA\u5B57\u4E32",
+    mongo_uri_conflicts_fields: "--uri \u4E0D\u80FD\u8207 {flags} \u4E26\u7528\uFF1A\u9023\u7DDA\u5B57\u4E32\u5DF2\u5305\u542B\u9019\u4E9B\u8A2D\u5B9A\u3002\u8ACB\u64C7\u4E00\u4F7F\u7528\uFF08--name \u53EF\u4E26\u7528\uFF0C\u7528\u4F86\u8986\u84CB\u8CC7\u6599\u5EAB\u540D\u7A31\uFF09\u3002",
+    mongo_uri_with_env_refs: "--uri \u4E0D\u80FD\u8207 --use-env-refs \u4E26\u7528\uFF1A\u9023\u7DDA\u5B57\u4E32\u6703\u88AB\u62C6\u89E3\u6210\u6B04\u4F4D\u8A2D\u5B9A\u5BEB\u5165\uFF0C\u5E33\u5BC6\u4E0D\u6703\u88AB\u62BD\u6210\u74B0\u5883\u8B8A\u6578\u53C3\u7167\u3002\u8ACB\u6539\u8D70\u4E0B\u5217\u4EFB\u4E00\u505A\u6CD5\uFF1A\u62FF\u6389 --use-env-refs\uFF0C\u8B93 dbcli \u62C6\u89E3\u5B57\u4E32\u5BEB\u5165\u6B04\u4F4D\u8A2D\u5B9A\uFF1B\u6216\u6539\u7528 --env-* flag\uFF08--env-host\u3001--env-user\u3001--env-password \u7B49\uFF09\u9010\u6B04\u7D66\u8B8A\u6578\u540D\u7A31\u3002",
+    mongo_uri_fallback_warning: "\u26A0\uFE0F  \u6B64\u9023\u7DDA\u5B57\u4E32{reasons}\uFF0C\u7121\u6CD5\u62C6\u6210\u6B04\u4F4D\u8A2D\u5B9A\uFF0C\u5DF2\u539F\u6A23\u5B58\u5165 uri\uFF1B\u5E33\u5BC6\u5C07\u660E\u6587\u5B58\u653E\u65BC\u8A2D\u5B9A\u6A94\u3002",
+    mongo_uri_reason_multi_host: "\u542B\u591A\u7D44 host\uFF08\u6B04\u4F4D\u8A2D\u5B9A\u53EA\u80FD\u8868\u9054\u4E00\u7D44\uFF09",
+    mongo_uri_reason_secret_option: "\u542B\u6A5F\u5BC6 option\uFF08{keys}\uFF09\uFF0C\u62C6\u9032 options \u6703\u660E\u6587\u843D\u76E4",
+    mongo_uri_reason_duplicate_key: "\u542B\u91CD\u8907\u7684 query \u9375\uFF08{keys}\uFF09\uFF08\u6B04\u4F4D\u8A2D\u5B9A\u6BCF\u500B\u9375\u53EA\u80FD\u5B58\u4E00\u500B\u503C\uFF09",
+    mongo_uri_reason_non_scram: "\u4F7F\u7528\u975E SCRAM \u7684\u8A8D\u8B49\u6A5F\u5236 {mechanism}\uFF08\u6B04\u4F4D\u8A2D\u5B9A\u7121\u6CD5\u8868\u9054\uFF09",
+    mongo_decomposed_header: "\u9023\u7DDA\u5B57\u4E32\u5DF2\u62C6\u89E3\u6210\u4E0B\u5217\u6B04\u4F4D\uFF08\u5BC6\u78BC\u5DF2\u906E\u853D\uFF09\uFF1A",
+    mongo_paste_env_refs_warning: "\u26A0\uFE0F  --use-env-refs \u4E0D\u9069\u7528\u65BC\u8CBC\u4E0A\u7684\u9023\u7DDA\u5B57\u4E32\uFF1A\u5E33\u5BC6\u6703\u4EE5\u5B57\u9762\u503C\u5BEB\u5165\u8A2D\u5B9A\u6A94\uFF0C\u4E0D\u6703\u8B8A\u6210\u74B0\u5883\u8B8A\u6578\u53C3\u7167\u3002",
+    mongo_setup_mode_paste: "\u8CBC\u4E0A\u9023\u7DDA\u5B57\u4E32\uFF08Atlas / Compass \u8907\u88FD\u7684\uFF09",
+    mongo_string_invalid: "\u4E0D\u662F\u5408\u6CD5\u7684 MongoDB \u9023\u7DDA\u5B57\u4E32\uFF08\u5B57\u4E32\u53EF\u80FD\u5E36\u6709\u5E33\u5BC6\uFF0C\u6240\u4EE5\u4E0D\u5370\u51FA\uFF09\u3002",
+    mongo_string_bad_host: "\u9023\u7DDA\u5B57\u4E32\u7684 host \u6216\u57E0\u865F\u4E0D\u5408\u6CD5\uFF08\u57E0\u865F\u9808\u70BA 1 \u81F3 65535 \u7684\u6574\u6578\uFF09\u3002",
+    mongo_string_bad_credentials: "\u9023\u7DDA\u5B57\u4E32\u7684\u5E33\u865F\u6216\u5BC6\u78BC\u542B\u6709\u672A\u8DF3\u812B\u7684\u4FDD\u7559\u5B57\u5143\uFF08\u5982 @\u3001:\u3001/\uFF09\u3002\u8ACB\u505A\u767E\u5206\u6BD4\u7DE8\u78BC\uFF08\u4F8B\u5982 @ \u5BEB\u6210 %40\uFF09\u3002",
+    mongo_string_tls_conflict: "\u9023\u7DDA\u5B57\u4E32\u540C\u6642\u6307\u5B9A\u4E86 tls \u8207 ssl \u4E14\u503C\u4E0D\u540C\u3002",
+    mongo_string_bad_tls: "\u9023\u7DDA\u5B57\u4E32\u7684 {key} \u53EA\u63A5\u53D7 true \u6216 false\u3002",
+    mongo_string_empty_option: "\u9023\u7DDA\u5B57\u4E32\u6307\u5B9A\u4E86 {key} \u537B\u6C92\u6709\u503C\u3002\u8ACB\u7D66\u503C\u6216\u79FB\u9664\u3002",
     prompt_name: "\u8CC7\u6599\u5EAB\u540D\u7A31\uFF1A",
     prompt_permission: "\u6B0A\u9650\u7B49\u7D1A\uFF08query-only, read-write, data-admin, admin\uFF09\uFF1A",
     env_parse_note: "\u63D0\u793A\uFF1A\u7121\u6CD5\u89E3\u6790 .env \u914D\u7F6E\uFF0C\u4F7F\u7528\u4E92\u52D5\u5F0F\u63D0\u793A",
@@ -1607,7 +1646,7 @@ var messages_default2 = {
     config_exists_use_force: ".dbcli \u5DF2\u5B58\u5728\u3002\u4F7F\u7528 --force \u9078\u9805\u8986\u84CB\u3002",
     connection_added: "\u5DF2\u65B0\u589E\u9023\u7DDA '{name}'",
     connection_removed: "\u5DF2\u79FB\u9664\u9023\u7DDA '{name}'",
-    connection_removed_switched: "\u5DF2\u79FB\u9664\u9023\u7DDA '{name}'\uFF0C\u9810\u8A2D\u9023\u7DDA\u5DF2\u5207\u63DB\u70BA '{newDefault}'",
+    connection_removed_default_cleared: "\u5DF2\u79FB\u9664\u9023\u7DDA '{name}'\uFF0C\u9810\u8A2D\u9023\u7DDA\u5DF2\u6E05\u7A7A\u3002\u57F7\u884C\u8CC7\u6599\u5EAB\u6307\u4EE4\u6642\u8ACB\u4F7F\u7528 --use <name> \u6216\u8A2D\u5B9A DBCLI_CONNECTION\u3002",
     connection_renamed: "\u5DF2\u5C07\u9023\u7DDA '{oldName}' \u91CD\u65B0\u547D\u540D\u70BA '{newName}'",
     v1_migration_prompt: "\u5075\u6E2C\u5230\u820A\u683C\u5F0F\u8A2D\u5B9A\uFF0C\u5C07\u5EFA\u7ACB\u65B0\u683C\u5F0F\u4E26\u5C07\u73FE\u6709\u9023\u7DDA\u532F\u5165\u70BA 'default'\uFF0C\u662F\u5426\u7E7C\u7E8C\uFF1F",
     config_saved_v2: "V2 \u8A2D\u5B9A\u5DF2\u5132\u5B58\u81F3 .dbcli",
@@ -1645,6 +1684,9 @@ var messages_default2 = {
     description: "\u5207\u63DB\u6216\u986F\u793A\u9810\u8A2D\u8CC7\u6599\u5EAB\u9023\u7DDA",
     switched: "\u5DF2\u5207\u63DB\u9810\u8A2D\u9023\u7DDA\u70BA {name}",
     current: "\u76EE\u524D\u7684\u9810\u8A2D\u9023\u7DDA\uFF1A{name}",
+    current_none: "\u76EE\u524D\u6C92\u6709\u9810\u8A2D\u9023\u7DDA\u3002\u8ACB\u4F7F\u7528 --use <name> \u6216\u8A2D\u5B9A DBCLI_CONNECTION\u3002",
+    unset: "\u9810\u8A2D\u9023\u7DDA\u5DF2\u6E05\u7A7A\u3002\u57F7\u884C\u8CC7\u6599\u5EAB\u6307\u4EE4\u6642\u8ACB\u4F7F\u7528 --use <name> \u6216\u8A2D\u5B9A DBCLI_CONNECTION\u3002",
+    unset_conflict: "--unset \u4E0D\u53EF\u8207\u9023\u7DDA\u540D\u7A31\u3001--list\u3001--confirm-production \u6216 --format json \u540C\u6642\u4F7F\u7528",
     requires_v2: "\u6B64\u529F\u80FD\u9700\u8981\u65B0\u683C\u5F0F\u8A2D\u5B9A\u3002\u8ACB\u4F7F\u7528 dbcli init --conn-name <\u540D\u7A31> \u5EFA\u7ACB\u591A\u9023\u7DDA\u8A2D\u5B9A",
     available: "\u53EF\u7528\u9023\u7DDA"
   },
@@ -8486,6 +8528,24 @@ var TimeoutField = {
   timeout: numberType().int().min(MIN_CONNECTION_TIMEOUT_MS).max(MAX_CONNECTION_TIMEOUT_MS).optional(),
   statementTimeout: numberType().int().min(MIN_STATEMENT_TIMEOUT_MS).max(MAX_STATEMENT_TIMEOUT_MS).optional()
 };
+var RESERVED_MONGODB_OPTION_KEYS = {
+  authsource: "authSource",
+  replicaset: "replicaSet",
+  tls: "tls",
+  ssl: "tls"
+};
+var MongoDBOptionsSchema = recordType(stringType(), stringType()).superRefine((options, ctx) => {
+  for (const key of Object.keys(options)) {
+    const field = RESERVED_MONGODB_OPTION_KEYS[key.toLowerCase()];
+    if (field) {
+      ctx.addIssue({
+        code: ZodIssueCode.custom,
+        path: [key],
+        message: `options.${key} duplicates the dedicated '${field}' field; set '${field}' instead`
+      });
+    }
+  }
+});
 var MongoDBConnectionConfigSchema = objectType({
   system: literalType("mongodb"),
   uri: unionType([stringType(), EnvRefSchema]).optional(),
@@ -8497,6 +8557,7 @@ var MongoDBConnectionConfigSchema = objectType({
   authSource: unionType([stringType(), EnvRefSchema]).optional(),
   replicaSet: unionType([stringType(), EnvRefSchema]).optional(),
   tls: booleanType().optional(),
+  options: MongoDBOptionsSchema.optional(),
   srv: booleanType().optional().default(false),
   ...TimeoutField
 });
@@ -8676,7 +8737,7 @@ var NamedConnectionSchema = preprocessType((raw, ctx) => {
 }, NamedConnectionUnion);
 var DbcliConfigV2Schema = objectType({
   version: literalType(2),
-  default: stringType().min(1),
+  default: stringType().min(1).optional(),
   connections: recordType(NamedConnectionSchema).refine((conns) => Object.keys(conns).length > 0, {
     message: "At least one connection is required"
   }),
@@ -8686,7 +8747,7 @@ var DbcliConfigV2Schema = objectType({
   blacklist: BlacklistConfigSchema,
   audit: AuditConfigSchema,
   redis: RedisConfigSchema
-}).refine((config) => (config.default in config.connections), {
+}).refine((config) => config.default === undefined || Object.hasOwn(config.connections, config.default), {
   message: "Default connection must exist in connections",
   path: ["default"]
 });
@@ -9037,14 +9098,26 @@ function findSimilarConnectionNames(requestedName, availableNames) {
   }).filter(({ isSimilar }) => isSimilar).sort((a, b) => a.distance - b.distance || a.name.localeCompare(b.name)).slice(0, 3).map(({ name }) => name);
 }
 function connectionNotFoundMessage(requestedName, availableNames) {
+  if (requestedName === undefined) {
+    return "\u5C1A\u672A\u8A2D\u5B9A\u9810\u8A2D\u9023\u7DDA\u3002\u8ACB\u4F7F\u7528 --use <name> \u6216\u8A2D\u5B9A DBCLI_CONNECTION \u660E\u78BA\u6307\u5B9A\u9023\u7DDA\u3002" + ` \u53EF\u7528\u9023\u7DDA\uFF1A${availableNames.join(", ")}`;
+  }
   const suggestions = findSimilarConnectionNames(requestedName, availableNames);
   const suggestion = suggestions.length > 0 ? ` \u4F60\u662F\u5426\u8981\u4F7F\u7528\uFF1A${suggestions.join("\u3001")}\uFF1F` : "";
   return `\u9023\u7DDA '${requestedName}' \u4E0D\u5B58\u5728\u3002${suggestion} \u53EF\u7528\u9023\u7DDA\uFF1A${availableNames.join(", ")}`;
 }
+
+class ConnectionSelectionRequiredError extends ConfigError {
+  constructor(availableNames) {
+    super(connectionNotFoundMessage(undefined, availableNames));
+  }
+}
 function resolveConnection(config, name) {
   const connectionName = name ?? config.default;
+  if (connectionName === undefined) {
+    throw new ConnectionSelectionRequiredError(Object.keys(config.connections));
+  }
   const conn = config.connections[connectionName];
-  if (!conn) {
+  if (!Object.hasOwn(config.connections, connectionName) || !conn) {
     throw new ConfigError(connectionNotFoundMessage(connectionName, Object.keys(config.connections)));
   }
   const { permission, envFile, environment, ...connectionFields } = conn;
@@ -9062,7 +9135,7 @@ async function loadConnectionEnv(resolved, basePath) {
     await loadEnvFile(envPath);
   }
 }
-async function readV2Config(path) {
+async function readV2ConfigDocument(path) {
   const storagePath = await resolveConfigStoragePath(path);
   const configPath = join7(storagePath, "config.json");
   const file = Bun.file(configPath);
@@ -9072,8 +9145,10 @@ async function readV2Config(path) {
   await assertAgentReadableFile(configPath);
   const content = await file.text();
   await assertConfigIntegrity(storagePath, content, { requireRecord: true });
-  const raw = JSON.parse(content);
-  return DbcliConfigV2Schema.parse(raw);
+  return JSON.parse(content);
+}
+async function readV2Config(path) {
+  return DbcliConfigV2Schema.parse(await readV2ConfigDocument(path));
 }
 async function writeV2Config(path, config) {
   assertConfigMutationApproved();
@@ -9104,18 +9179,20 @@ function envVarNameFor(connName, field) {
   return `DBCLI_${slug}_${field.toUpperCase()}`;
 }
 function removeConnection(config, name) {
-  if (!(name in config.connections))
+  if (!Object.hasOwn(config.connections, name))
     throw new Error(`\u9023\u7DDA '${name}' \u4E0D\u5B58\u5728`);
   const rest = { ...config.connections };
   delete rest[name];
   const remaining = Object.keys(rest);
   if (remaining.length === 0)
     throw new Error("\u7121\u6CD5\u522A\u9664\u6700\u5F8C\u4E00\u689D\u9023\u7DDA");
-  const nextDefault = config.default === name ? remaining[0] : config.default;
-  return { ...config, connections: rest, default: nextDefault };
+  const updated = { ...config, connections: rest };
+  if (config.default === name)
+    delete updated.default;
+  return updated;
 }
 function setDefaultConnection(config, name) {
-  if (!(name in config.connections))
+  if (!Object.hasOwn(config.connections, name))
     throw new Error(`\u9023\u7DDA '${name}' \u4E0D\u5B58\u5728`);
   return { ...config, default: name };
 }
@@ -9240,15 +9317,11 @@ async function resolvePasswordTarget(projectPath, connectionName) {
     };
   }
   const config = await readV2Config(projectPath);
-  const targetName = connectionName ?? config.default;
-  const connection = config.connections[targetName];
-  if (!connection) {
-    throw new ConfigError(connectionNotFoundMessage(targetName, Object.keys(config.connections)));
-  }
+  const { name: targetName, connection, envFile } = resolveConnection(config, connectionName);
   const referencedVar = envRefName(connection.password);
   return {
     connection: targetName,
-    envFile: connection.envFile ?? DEFAULT_ENV_FILE,
+    envFile: envFile ?? DEFAULT_ENV_FILE,
     varName: referencedVar ?? envVarNameFor(targetName, "password"),
     convertedToEnvRef: referencedVar === undefined
   };

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "dbcli-agent",
-  "version": "9.1.2",
+  "version": "11.0.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": "9.1.2",
+  "version": "11.0.0",
   "description": "Database CLI for AI agents",
   "type": "module",
   "publishConfig": {
@@ -41,7 +41,7 @@
     "blacklist"
   ],
   "engines": {
-    "bun": ">=1.3.3"
+    "bun": ">=1.4.0"
   },
   "files": [
     "dist/",
@@ -100,6 +100,7 @@
     "lru-cache": "^11.4.0",
     "lucide-react": "^1.16.0",
     "mongodb": "^7.2.0",
+    "mongodb-connection-string-url": "^7.0.1",
     "mysql2": "^3.24.3",
     "node-sql-parser": "5",
     "open": "^11.0.0",

package/plugins/dbcli-agent/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "dbcli-agent",
-  "version": "9.1.2",
+  "version": "11.0.0",
   "description": "Database CLI skill and command reference for AI agents",
   "author": {
     "name": "Carl Lee",