@carllee1983/dbcli 1.44.1 → 1.45.0

package/dist/core.d.ts

@@ -1436,6 +1436,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 				"admin"
 			]>>;
 			envFile: z.ZodOptional<z.ZodString>;
+			environment: z.ZodOptional<z.ZodEffects<z.ZodString, string | undefined, string>>;
 		}, "strip", z.ZodTypeAny, {
 			password: string | {
 				$env: string;
@@ -1455,6 +1456,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			};
 			permission: "admin" | "query-only" | "read-write" | "data-admin";
 			envFile?: string | undefined;
+			environment?: string | undefined;
 		}, {
 			user: string | {
 				$env: string;
@@ -1474,6 +1476,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			} | undefined;
 			permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 			envFile?: string | undefined;
+			environment?: string | undefined;
 		}>,
 		z.ZodObject<{
 			system: z.ZodLiteral<"mongodb">;
@@ -1545,6 +1548,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 				"admin"
 			]>>;
 			envFile: z.ZodOptional<z.ZodString>;
+			environment: z.ZodOptional<z.ZodEffects<z.ZodString, string | undefined, string>>;
 		}, "strip", z.ZodTypeAny, {
 			password: string | {
 				$env: string;
@@ -1567,6 +1571,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 				$env: string;
 			} | undefined;
 			envFile?: string | undefined;
+			environment?: string | undefined;
 		}, {
 			system: "mongodb";
 			password?: string | {
@@ -1589,6 +1594,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			} | undefined;
 			permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 			envFile?: string | undefined;
+			environment?: string | undefined;
 		}>,
 		z.ZodObject<{
 			system: z.ZodLiteral<"redis">;
@@ -1650,6 +1656,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 				"admin"
 			]>>;
 			envFile: z.ZodOptional<z.ZodString>;
+			environment: z.ZodOptional<z.ZodEffects<z.ZodString, string | undefined, string>>;
 		}, "strip", z.ZodTypeAny, {
 			password: string | {
 				$env: string;
@@ -1669,6 +1676,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			};
 			permission: "admin" | "query-only" | "read-write" | "data-admin";
 			envFile?: string | undefined;
+			environment?: string | undefined;
 		}, {
 			system: "redis";
 			host: string | {
@@ -1688,6 +1696,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			} | undefined;
 			permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 			envFile?: string | undefined;
+			environment?: string | undefined;
 		}>,
 		z.ZodObject<{
 			system: z.ZodLiteral<"elasticsearch">;
@@ -1776,6 +1785,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 				"admin"
 			]>>;
 			envFile: z.ZodOptional<z.ZodString>;
+			environment: z.ZodOptional<z.ZodEffects<z.ZodString, string | undefined, string>>;
 		}, "strip", z.ZodTypeAny, {
 			password: string | {
 				$env: string;
@@ -1805,6 +1815,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			} | undefined;
 			caPath?: string | undefined;
 			envFile?: string | undefined;
+			environment?: string | undefined;
 		}, {
 			system: "elasticsearch";
 			password?: string | {
@@ -1834,6 +1845,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			caPath?: string | undefined;
 			permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 			envFile?: string | undefined;
+			environment?: string | undefined;
 		}>
 	]>>, Record<string, {
 		password: string | {
@@ -1854,6 +1866,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		};
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		password: string | {
 			$env: string;
@@ -1876,6 +1889,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			$env: string;
 		} | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		password: string | {
 			$env: string;
@@ -1895,6 +1909,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		};
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		password: string | {
 			$env: string;
@@ -1924,6 +1939,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		} | undefined;
 		caPath?: string | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	}>, Record<string, {
 		user: string | {
 			$env: string;
@@ -1943,6 +1959,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		} | undefined;
 		permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		system: "mongodb";
 		password?: string | {
@@ -1965,6 +1982,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		} | undefined;
 		permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		system: "redis";
 		host: string | {
@@ -1984,6 +2002,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		} | undefined;
 		permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		system: "elasticsearch";
 		password?: string | {
@@ -2013,6 +2032,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		caPath?: string | undefined;
 		permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	}>>;
 	schema: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
 	schemas: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>>>>;
@@ -2129,6 +2149,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		};
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		password: string | {
 			$env: string;
@@ -2151,6 +2172,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			$env: string;
 		} | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		password: string | {
 			$env: string;
@@ -2170,6 +2192,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		};
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		password: string | {
 			$env: string;
@@ -2199,6 +2222,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		} | undefined;
 		caPath?: string | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	}>;
 	schemas: Record<string, Record<string, any>>;
 	redis?: {
@@ -2229,6 +2253,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		} | undefined;
 		permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		system: "mongodb";
 		password?: string | {
@@ -2251,6 +2276,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		} | undefined;
 		permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		system: "redis";
 		host: string | {
@@ -2270,6 +2296,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		} | undefined;
 		permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		system: "elasticsearch";
 		password?: string | {
@@ -2299,6 +2326,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		caPath?: string | undefined;
 		permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	}>;
 	redis?: {
 		mask?: {
@@ -2365,6 +2393,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		};
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		password: string | {
 			$env: string;
@@ -2387,6 +2416,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			$env: string;
 		} | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		password: string | {
 			$env: string;
@@ -2406,6 +2436,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		};
 		permission: "admin" | "query-only" | "read-write" | "data-admin";
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		password: string | {
 			$env: string;
@@ -2435,6 +2466,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		} | undefined;
 		caPath?: string | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	}>;
 	schemas: Record<string, Record<string, any>>;
 	redis?: {
@@ -2465,6 +2497,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		} | undefined;
 		permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		system: "mongodb";
 		password?: string | {
@@ -2487,6 +2520,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		} | undefined;
 		permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		system: "redis";
 		host: string | {
@@ -2506,6 +2540,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		} | undefined;
 		permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	} | {
 		system: "elasticsearch";
 		password?: string | {
@@ -2535,6 +2570,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		caPath?: string | undefined;
 		permission?: "admin" | "query-only" | "read-write" | "data-admin" | undefined;
 		envFile?: string | undefined;
+		environment?: string | undefined;
 	}>;
 	redis?: {
 		mask?: {
@@ -2892,6 +2928,7 @@ export interface ResolvedConnection {
 	};
 	permission: "query-only" | "read-write" | "data-admin" | "admin";
 	envFile?: string;
+	environment?: string;
 }
 /**
  * Resolve a named connection from v2 config
@@ -2906,9 +2943,7 @@ export declare function loadConnectionEnv(resolved: ResolvedConnection, basePath
  */
 export declare function readV2Config(path: string): Promise<DbcliConfigV2>;
 /**
- * Write a v2 config to disk atomically (temp file + rename).
- * Writing to a temp file then renaming over the target is an atomic operation
- * on the same filesystem, so a crash mid-write can never leave a corrupt config.
+ * Write a v2 config and its integrity records as one recoverable publication.
  */
 export declare function writeV2Config(path: string, config: DbcliConfigV2): Promise<void>;
 /**
@@ -2960,6 +2995,12 @@ 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;
+/**
+ * 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
+ * dbcli-specific override; otherwise preserve the existing `~/.config` path.
+ */
+export declare function getDbcliConfigHome(): string;
 interface ProjectConfigBinding {
 	version: 3;
 	binding: {
@@ -2969,6 +3010,10 @@ interface ProjectConfigBinding {
 		createdAt: string;
 	};
 }
+/** Canonical user-global configuration directory (`~/.config/dbcli`). */
+export declare function getGlobalConfigPath(): string;
+/** Whether a path points at the canonical user-global configuration directory. */
+export declare function isGlobalConfigPath(path: string): boolean;
 export declare function getProjectStoragePath(projectPath: string): string;
 export declare function resolveConfigStoragePath(path: string): Promise<string>;
 export declare function writeProjectBinding(projectPath: string, storagePath?: string): Promise<ProjectConfigBinding>;