@carllee1983/dbcli 1.41.0 → 1.43.0

package/dist/core.d.ts

@@ -250,6 +250,7 @@ interface QueryableAdapter {
 	execute<T>(query: string, params?: unknown[], options?: {
 		limit?: number;
 		noLimit?: boolean;
+		projection?: Record<string, 0 | 1>;
 	}): Promise<ExecutionResult<T>>;
 	/**
 	 * List all collections in the connected database
@@ -493,6 +494,12 @@ interface DbcliConfig {
 	metadata?: Metadata;
 	blacklist?: BlacklistConfig;
 }
+interface AppliedLimitMetadata {
+	/** True only when the caller fetched and removed an additional row. */
+	truncated: boolean;
+	/** User-facing row limit, never the internal lookahead size. */
+	limitApplied: number;
+}
 type SqlStatementType = "SELECT" | "INSERT" | "UPDATE" | "DELETE" | "UNKNOWN";
 interface QueryMetadata {
 	/** SQL statement type (SELECT, INSERT, UPDATE, DELETE) */
@@ -534,6 +541,8 @@ export interface QueryResult<T> {
 	executionTimeMs?: number;
 	/** Optional: metadata about query type and affected rows */
 	metadata?: QueryMetadata;
+	/** Internal row-limit proof, mapped into public JSON metadata by the formatter. */
+	appliedLimit?: AppliedLimitMetadata;
 }
 /**
  * Manager class for loading and querying blacklist rules.
@@ -2554,6 +2563,13 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 	schemas?: Record<string, Record<string, any>> | undefined;
 }>;
 export type DbcliConfigV2 = z.infer<typeof DbcliConfigV2Schema>;
+type FieldSelection = {
+	mode: "include";
+	paths: readonly string[];
+} | {
+	mode: "exclude";
+	paths: readonly string[];
+};
 /**
  * QueryExecutor class for executing SQL queries with permission checks
  */
@@ -2563,9 +2579,14 @@ export declare class QueryExecutor {
 	private blacklistValidator?;
 	private config?;
 	private options;
+	private pendingDiagnostics;
 	constructor(adapter: DatabaseAdapter, permission: Permission, blacklistValidator?: BlacklistValidator | undefined, config?: DbcliConfig$1 | undefined, options?: {
 		config?: string;
+		connectionName?: string;
+		recovery?: boolean;
+		deferDiagnostics?: boolean;
 	});
+	takeDiagnostics(): string[];
 	/**
 	 * Execute a SQL query with permission enforcement and error handling
 	 *
@@ -2579,6 +2600,8 @@ export declare class QueryExecutor {
 	execute(sql: string, options?: {
 		autoLimit?: boolean;
 		limitValue?: number;
+		detectTruncation?: boolean;
+		fieldSelection?: FieldSelection;
 	}): Promise<QueryResult<Record<string, unknown>>>;
 }
 /**