admindb 2.1.0 → 2.2.1

package/dist/db/database.d.ts

@@ -1,119 +1 @@
-import type { Logger } from '../utils/logger';
-import { type ColumnDef, type IndexDef } from '../sql/generator';
-import type { DatabaseDialect, DbOpenOptions, IDatabase, ReferencingTableInfo, Result, RowFilters, SavedQuery, SchemaInfo, SQLInputValue, TableInfoData, TableListItem, WhereClause } from './types';
-export * from './types';
-export * from './filters';
-/**
- * Promise-style wrapper around the better-sqlite3 driver.
- * Every call returns a consistent `{ success, data?, error? }` shape and
- * performs one-time, idempotent schema initialization.
- */
-export declare class SqliteDatabase implements IDatabase {
-    private db;
-    private logger;
-    readonly path: string;
-    readonly isReadOnly: boolean;
-    readonly dialect: DatabaseDialect;
-    constructor(dbPath: string, logger: Logger, options?: DbOpenOptions);
-    private readonlyBlocked;
-    close(): void;
-    private initSchema;
-    private tryRun;
-    /** Run an atomic transaction. Reverts on any error and enforces read-only mode. */
-    private transaction;
-    private toBind;
-    all(sql: string, params?: SQLInputValue[]): Promise<Result<unknown[]>>;
-    run(sql: string, params?: SQLInputValue[]): Promise<Result<{
-        changes: number;
-        lastInsertRowid: number | null;
-    }>>;
-    execResult(sql: string): Promise<Result<{
-        changes?: number;
-    }>>;
-    hasMultipleStatements(sql: string): boolean;
-    runWrite(sql: string): Promise<Result<{
-        changes?: number;
-    }>>;
-    listTables(): Promise<Result<TableListItem[]>>;
-    getTableInfo(table: string): Promise<Result<TableInfoData>>;
-    getRowCount(table: string, filters?: RowFilters): Promise<Result<number>>;
-    getRows(table: string, opts?: {
-        page?: number;
-        limit?: number;
-        orderBy?: string;
-        orderDir?: 'asc' | 'desc';
-        filters?: RowFilters;
-    }): Promise<Result<Record<string, unknown>[]>>;
-    getAllRows(table: string): Promise<Result<Record<string, unknown>[]>>;
-    getRow(table: string, where: WhereClause[]): Promise<Result<Record<string, unknown> | null>>;
-    insertRow(table: string, fields: WhereClause[]): Promise<Result<{
-        changes: number;
-        lastInsertRowid: number | null;
-    }>>;
-    /** Insert many rows inside a single atomic transaction. */
-    insertRows(table: string, rows: WhereClause[][]): Promise<Result<{
-        inserted: number;
-        skipped: number;
-    }>>;
-    updateRow(table: string, fields: WhereClause[], where: WhereClause[]): Promise<Result<{
-        changes: number;
-        lastInsertRowid: number | null;
-    }>>;
-    /** Apply many row updates inside a single atomic transaction. */
-    updateRows(table: string, rows: {
-        fields: WhereClause[];
-        where: WhereClause[];
-    }[]): Promise<Result<{
-        updated: number;
-    }>>;
-    deleteRow(table: string, where: WhereClause[]): Promise<Result<{
-        changes: number;
-        lastInsertRowid: number | null;
-    }>>;
-    /** Delete many rows inside a single atomic transaction. */
-    deleteRows(table: string, rows: WhereClause[][]): Promise<Result<{
-        deleted: number;
-    }>>;
-    getRowsByPks(table: string, pks: WhereClause[][]): Promise<Result<Record<string, unknown>[]>>;
-    getCreateStatement(table: string): Promise<Result<string | null>>;
-    listSavedQueries(): Promise<Result<SavedQuery[]>>;
-    saveQuery(name: string, sql: string): Promise<Result<{
-        changes: number;
-        lastInsertRowid: number | null;
-    }>>;
-    deleteSavedQuery(id: string | number): Promise<Result<{
-        changes: number;
-        lastInsertRowid: number | null;
-    }>>;
-    getSchema(table: string): Promise<Result<SchemaInfo>>;
-    getReferencingTables(table: string): Promise<Result<ReferencingTableInfo[]>>;
-    getRowsByFk(table: string, column: string, value: unknown, limit?: number): Promise<Result<{
-        rows: Record<string, unknown>[];
-        total: number;
-    }>>;
-    renameTable(oldName: string, newName: string): Promise<Result<{
-        changes?: number;
-    }>>;
-    addColumn(table: string, col: ColumnDef): Promise<Result<{
-        changes?: number;
-    }>>;
-    modifyColumn(table: string, oldColName: string, newColDef: ColumnDef): Promise<Result<{
-        changes?: number;
-    }>>;
-    renameColumn(table: string, oldName: string, newName: string): Promise<Result<{
-        changes?: number;
-    }>>;
-    dropColumn(table: string, column: string): Promise<Result<{
-        changes?: number;
-    }>>;
-    dropTable(table: string): Promise<Result<{
-        changes?: number;
-    }>>;
-    createIndex(table: string, index: IndexDef): Promise<Result<{
-        changes?: number;
-    }>>;
-    dropIndex(indexName: string): Promise<Result<{
-        changes?: number;
-    }>>;
-    private getTableInfoSync;
-}
+import type {Logger} from '../utils/logger';import{type ColumnDef,type IndexDef} from '../sql/generator';import type {DatabaseDialect,DbOpenOptions,IDatabase,ReferencingTableInfo,Result,RowFilters,SavedQuery,SchemaInfo,SQLInputValue,TableInfoData,TableListItem,WhereClause} from './types';export * from './types';export * from './filters';export declare class SqliteDatabase implements IDatabase{private db;private logger;readonly path:string;readonly isReadOnly:boolean;readonly dialect:DatabaseDialect;constructor(dbPath:string,logger:Logger,options?:DbOpenOptions);private readonlyBlocked;close():void;private initSchema;private tryRun;private transaction;private toBind;all(sql:string,params?:SQLInputValue[]):Promise<Result<unknown[]>>;run(sql:string,params?:SQLInputValue[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;execResult(sql:string):Promise<Result<{changes?:number;}>>;hasMultipleStatements(sql:string):boolean;runWrite(sql:string):Promise<Result<{changes?:number;}>>;listTables():Promise<Result<TableListItem[]>>;getTableInfo(table:string):Promise<Result<TableInfoData>>;getRowCount(table:string,filters?:RowFilters):Promise<Result<number>>;getRows(table:string,opts?:{page?:number;limit?:number;orderBy?:string;orderDir?:'asc'|'desc';filters?:RowFilters;}):Promise<Result<Record<string,unknown>[]>>;getAllRows(table:string):Promise<Result<Record<string,unknown>[]>>;getRow(table:string,where:WhereClause[]):Promise<Result<Record<string,unknown>|null>>;insertRow(table:string,fields:WhereClause[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;insertRows(table:string,rows:WhereClause[][]):Promise<Result<{inserted:number;skipped:number;}>>;updateRow(table:string,fields:WhereClause[],where:WhereClause[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;updateRows(table:string,rows:{fields:WhereClause[];where:WhereClause[];}[]):Promise<Result<{updated:number;}>>;deleteRow(table:string,where:WhereClause[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;deleteRows(table:string,rows:WhereClause[][]):Promise<Result<{deleted:number;}>>;getRowsByPks(table:string,pks:WhereClause[][]):Promise<Result<Record<string,unknown>[]>>;getCreateStatement(table:string):Promise<Result<string|null>>;listSavedQueries():Promise<Result<SavedQuery[]>>;saveQuery(name:string,sql:string):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;deleteSavedQuery(id:string|number):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;getSettings():Promise<Result<Record<string,string>>>;getSchema(table:string):Promise<Result<SchemaInfo>>;getReferencingTables(table:string):Promise<Result<ReferencingTableInfo[]>>;getRowsByFk(table:string,column:string,value:unknown,limit?:number):Promise<Result<{rows:Record<string,unknown>[];total:number;}>>;renameTable(oldName:string,newName:string):Promise<Result<{changes?:number;}>>;addColumn(table:string,col:ColumnDef):Promise<Result<{changes?:number;}>>;modifyColumn(table:string,oldColName:string,newColDef:ColumnDef):Promise<Result<{changes?:number;}>>;renameColumn(table:string,oldName:string,newName:string):Promise<Result<{changes?:number;}>>;dropColumn(table:string,column:string):Promise<Result<{changes?:number;}>>;dropTable(table:string):Promise<Result<{changes?:number;}>>;createIndex(table:string,index:IndexDef):Promise<Result<{changes?:number;}>>;dropIndex(indexName:string):Promise<Result<{changes?:number;}>>;private getTableInfoSync;}

package/dist/db/database.js

@@ -27,11 +27,6 @@ const introspection_1 = require("./introspection");
 const migrations_1 = require("./migrations");
 __exportStar(require("./types"), exports);
 __exportStar(require("./filters"), exports);
-/**
- * Promise-style wrapper around the better-sqlite3 driver.
- * Every call returns a consistent `{ success, data?, error? }` shape and
- * performs one-time, idempotent schema initialization.
- */
 class SqliteDatabase {
     db;
     logger;
@@ -85,7 +80,6 @@ class SqliteDatabase {
             return { success: false, error: msg };
         }
     }
-    /** Run an atomic transaction. Reverts on any error and enforces read-only mode. */
     transaction(fn) {
         if (this.isReadOnly)
             return Promise.resolve(this.readonlyBlocked());
@@ -100,7 +94,7 @@ class SqliteDatabase {
                 try {
                     this.db.exec('ROLLBACK');
                 }
-                catch { /* ignore */ }
+                catch { }
                 throw err;
             }
         });
@@ -218,7 +212,6 @@ class SqliteDatabase {
         const sql = `INSERT INTO ${(0, generator_1.quoteIdentifier)(table)} (${cols.join(', ')}) VALUES (${fields.map(() => '?').join(', ')})`;
         return this.run(sql, fields.map((f) => this.toBind(f.value)));
     }
-    /** Insert many rows inside a single atomic transaction. */
     async insertRows(table, rows) {
         return this.transaction(() => {
             let inserted = 0;
@@ -239,7 +232,6 @@ class SqliteDatabase {
         const sql = `UPDATE ${(0, generator_1.quoteIdentifier)(table)} SET ${sets.join(', ')} WHERE ${conds.join(' AND ')}`;
         return this.run(sql, [...fields.map((f) => this.toBind(f.value)), ...where.map((w) => this.toBind(w.value))]);
     }
-    /** Apply many row updates inside a single atomic transaction. */
     async updateRows(table, rows) {
         return this.transaction(() => {
             let updated = 0;
@@ -260,7 +252,6 @@ class SqliteDatabase {
         const sql = `DELETE FROM ${(0, generator_1.quoteIdentifier)(table)} WHERE ${conds.join(' AND ')}`;
         return this.run(sql, where.map((w) => this.toBind(w.value)));
     }
-    /** Delete many rows inside a single atomic transaction. */
     async deleteRows(table, rows) {
         return this.transaction(() => {
             let deleted = 0;
@@ -308,6 +299,23 @@ class SqliteDatabase {
     async deleteSavedQuery(id) {
         return this.run(`DELETE FROM ${(0, generator_1.quoteIdentifier)(types_1.INTERNAL_TABLES.savedQueries)} WHERE id = ?`, [Number(id)]);
     }
+    async getSettings() {
+        return this.tryRun(() => {
+            const pragmas = ['journal_mode', 'synchronous', 'foreign_keys', 'page_size', 'encoding', 'auto_vacuum', 'mmap_size', 'temp_store'];
+            const settings = {};
+            for (const p of pragmas) {
+                try {
+                    const row = this.db.prepare(`PRAGMA ${p}`).get();
+                    if (row && p in row) {
+                        settings[p] = String(row[p]);
+                    }
+                }
+                catch {
+                }
+            }
+            return settings;
+        });
+    }
     async getSchema(table) {
         return this.tryRun(() => (0, introspection_1.getSchemaSync)(this.db, table));
     }
@@ -380,7 +388,6 @@ class SqliteDatabase {
             const defaultMatches = newColDef.defaultValue === undefined || String(newColDef.defaultValue ?? '').trim() === String(existing.dflt_value ?? '').trim();
             const fkMatches = newColDef.foreignKey === undefined || ((!newColDef.foreignKey && !existingFk) ||
                 (newColDef.foreignKey && existingFk && newColDef.foreignKey.table === existingFk.table && newColDef.foreignKey.column === existingFk.to));
-            // Fast path: if ONLY the column name changed, use native RENAME COLUMN.
             if (oldColName !== newName && typeMatches && pkMatches && notNullMatches && uniqueMatches && defaultMatches && fkMatches) {
                 this.db.exec((0, generator_1.generateRenameColumn)(table, oldColName, newName));
                 const existingIdxNames = new Set(indexRows.map((i) => i.name));
@@ -393,7 +400,7 @@ class SqliteDatabase {
                             this.db.exec(`DROP INDEX ${(0, generator_1.quoteIdentifier)(defaultOldIdx)};`);
                             this.db.exec(`CREATE ${uniqueKeyword}INDEX IF NOT EXISTS ${(0, generator_1.quoteIdentifier)(newIdxName)} ON ${(0, generator_1.quoteIdentifier)(table)} (${(0, generator_1.quoteIdentifier)(newName)});`);
                         }
-                        catch { /* ignore */ }
+                        catch { }
                     }
                 }
                 return { changes: 1 };
@@ -436,7 +443,7 @@ class SqliteDatabase {
                         this.db.exec(`DROP INDEX ${(0, generator_1.quoteIdentifier)(defaultOldIdx)};`);
                         this.db.exec(`CREATE ${uniqueKeyword}INDEX IF NOT EXISTS ${(0, generator_1.quoteIdentifier)(newIdxName)} ON ${(0, generator_1.quoteIdentifier)(table)} (${(0, generator_1.quoteIdentifier)(newName)});`);
                     }
-                    catch { /* ignore */ }
+                    catch { }
                 }
             }
             return { changes: 1 };
@@ -468,4 +475,3 @@ class SqliteDatabase {
     }
 }
 exports.SqliteDatabase = SqliteDatabase;
-//# sourceMappingURL=database.js.map

package/dist/db/export.d.ts

@@ -1,12 +1 @@
-import type { IDatabase } from './types';
-export interface DumpResult {
-    success: boolean;
-    data?: string;
-    error?: string;
-}
-/**
- * Produce a downloadable SQL dump: for every table emit its CREATE statement
- * followed by one INSERT statement per row. BLOB values are exported as
- * X'…' literals so they round-trip as real blobs.
- */
-export declare function generateSqlDump(db: IDatabase): Promise<DumpResult>;
+import type {IDatabase} from './types';export interface DumpResult{success:boolean;data?:string;error?:string;}export declare function generateSqlDump(db:IDatabase):Promise<DumpResult>;export declare function generateSchemaDump(db:IDatabase):Promise<DumpResult>;

package/dist/db/export.js

@@ -1,12 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateSqlDump = generateSqlDump;
+exports.generateSchemaDump = generateSchemaDump;
 const generator_1 = require("../sql/generator");
-/**
- * Produce a downloadable SQL dump: for every table emit its CREATE statement
- * followed by one INSERT statement per row. BLOB values are exported as
- * X'…' literals so they round-trip as real blobs.
- */
 async function generateSqlDump(db) {
     const out = [];
     if (db.dialect === 'sqlite') {
@@ -39,4 +35,56 @@ async function generateSqlDump(db) {
     out.push('COMMIT;');
     return { success: true, data: out.join('\n') };
 }
-//# sourceMappingURL=export.js.map
+async function generateSchemaDump(db) {
+    const out = [];
+    if (db.dialect === 'sqlite') {
+        const allSchemas = await db.all(`SELECT sql FROM sqlite_master WHERE sql IS NOT NULL AND name NOT LIKE 'sqlite_%' AND name NOT LIKE '_saved_queries'`);
+        if (allSchemas.success && allSchemas.data) {
+            for (const row of allSchemas.data) {
+                let stmt = String(row.sql).trim();
+                if (!stmt.endsWith(';'))
+                    stmt += ';';
+                out.push(stmt);
+                out.push('');
+            }
+        }
+        else {
+            return { success: false, error: allSchemas.error ?? 'Failed to read sqlite_master.' };
+        }
+    }
+    else {
+        const tables = await db.listTables();
+        if (!tables.success)
+            return { success: false, error: tables.error ?? 'Failed to list tables.' };
+        for (const t of tables.data ?? []) {
+            const name = t.name;
+            const info = await db.getTableInfo(name);
+            if (info.success && info.data) {
+                if (info.data.sql) {
+                    out.push(info.data.sql.trim());
+                }
+                if (info.data.foreignKeys && info.data.foreignKeys.length > 0) {
+                    for (const fk of info.data.foreignKeys) {
+                        if (fk.from && fk.to && fk.table) {
+                            let action = '';
+                            if (fk.on_delete && fk.on_delete !== 'NO ACTION')
+                                action += ` ON DELETE ${fk.on_delete}`;
+                            if (fk.on_update && fk.on_update !== 'NO ACTION')
+                                action += ` ON UPDATE ${fk.on_update}`;
+                            out.push(`ALTER TABLE "${name}" ADD FOREIGN KEY ("${fk.from}") REFERENCES "${fk.table}" ("${fk.to}")${action};`);
+                        }
+                    }
+                }
+                if (info.data.indexes && info.data.indexes.length > 0) {
+                    for (const idx of info.data.indexes) {
+                        if (idx.sql) {
+                            out.push(idx.sql.trim() + ';');
+                        }
+                    }
+                }
+                out.push('');
+            }
+        }
+    }
+    return { success: true, data: out.join('\n').trim() };
+}

package/dist/db/filters.d.ts

@@ -1,22 +1 @@
-import type { FilterCondition, RowFilters, SQLInputValue } from './types';
-/** Escape LIKE wildcards so user filter text is matched literally. */
-export declare function escapeLike(s: string): string;
-/**
- * Build a parameterized WHERE clause from per-column filters.
- *
- * A filter value is either:
- *   - the legacy string syntax: `=value` exact, `!=value`, `>value`, `>=value`,
- *     `<value`, `<=value`, `value*` prefix, anything else → substring match; or
- *   - a structured `FilterCondition` (or array of them) produced by the
- *     type-aware filter form (FK dropdowns, boolean toggles, date/number ranges).
- */
-export declare function pushFilterCondition(conds: string[], params: SQLInputValue[], quotedCol: string, c: FilterCondition): void;
-export declare function buildFilterClause(filters: RowFilters | undefined, availableCols: string[]): {
-    where: string;
-    params: SQLInputValue[];
-};
-/**
- * Replace SQLite-style `?` placeholders with PostgreSQL-style `$1, $2, ...`
- * placeholders while safely preserving single-quoted string literals.
- */
-export declare function convertPlaceholdersToPostgres(sql: string, startIdx?: number): string;
+import type {FilterCondition,RowFilters,SQLInputValue} from './types';export declare function escapeLike(s:string):string;export declare function pushFilterCondition(conds:string[],params:SQLInputValue[],quotedCol:string,c:FilterCondition):void;export declare function buildFilterClause(filters:RowFilters|undefined,availableCols:string[]):{where:string;params:SQLInputValue[];};export declare function convertPlaceholdersToPostgres(sql:string,startIdx?:number):string;

package/dist/db/filters.js

@@ -5,19 +5,9 @@ exports.pushFilterCondition = pushFilterCondition;
 exports.buildFilterClause = buildFilterClause;
 exports.convertPlaceholdersToPostgres = convertPlaceholdersToPostgres;
 const generator_1 = require("../sql/generator");
-/** Escape LIKE wildcards so user filter text is matched literally. */
 function escapeLike(s) {
     return String(s).replace(/[\\%_]/g, (m) => '\\' + m);
 }
-/**
- * Build a parameterized WHERE clause from per-column filters.
- *
- * A filter value is either:
- *   - the legacy string syntax: `=value` exact, `!=value`, `>value`, `>=value`,
- *     `<value`, `<=value`, `value*` prefix, anything else → substring match; or
- *   - a structured `FilterCondition` (or array of them) produced by the
- *     type-aware filter form (FK dropdowns, boolean toggles, date/number ranges).
- */
 function pushFilterCondition(conds, params, quotedCol, c) {
     const value = String(c.value ?? '');
     switch (c.op) {
@@ -88,7 +78,6 @@ function buildFilterClause(filters, availableCols) {
             pushFilterCondition(conds, params, q, raw);
             continue;
         }
-        // Legacy string syntax.
         const value = String(raw ?? '').trim();
         if (value === '')
             continue;
@@ -127,10 +116,6 @@ function buildFilterClause(filters, availableCols) {
     }
     return { where: conds.length ? ` WHERE ${conds.join(' AND ')}` : '', params };
 }
-/**
- * Replace SQLite-style `?` placeholders with PostgreSQL-style `$1, $2, ...`
- * placeholders while safely preserving single-quoted string literals.
- */
 function convertPlaceholdersToPostgres(sql, startIdx = 1) {
     let idx = startIdx;
     let inString = false;
@@ -155,4 +140,3 @@ function convertPlaceholdersToPostgres(sql, startIdx = 1) {
     }
     return result;
 }
-//# sourceMappingURL=filters.js.map

package/dist/db/index.d.ts

@@ -1,8 +1 @@
-export * from './types';
-export * from './filters';
-export * from './introspection';
-export * from './migrations';
-export * from './database';
-export * from './postgres';
-export * from './manager';
-export * from './export';
+export * from './types';export * from './filters';export * from './introspection';export * from './migrations';export * from './database';export * from './postgres';export * from './manager';export * from './export';

package/dist/db/index.js

@@ -22,4 +22,3 @@ __exportStar(require("./database"), exports);
 __exportStar(require("./postgres"), exports);
 __exportStar(require("./manager"), exports);
 __exportStar(require("./export"), exports);
-//# sourceMappingURL=index.js.map

package/dist/db/introspection.d.ts

@@ -1,6 +1 @@
-import type Database from 'better-sqlite3';
-import type { ReferencingTableInfo, SchemaInfo, TableInfoData, TableListItem } from './types';
-export declare function listTablesSync(db: Database.Database): TableListItem[];
-export declare function getTableInfoSync(db: Database.Database, table: string): TableInfoData;
-export declare function getSchemaSync(db: Database.Database, table: string): SchemaInfo;
-export declare function getReferencingTablesSync(db: Database.Database, table: string): ReferencingTableInfo[];
+import type Database from 'better-sqlite3';import type {ReferencingTableInfo,SchemaInfo,TableInfoData,TableListItem} from './types';export declare function listTablesSync(db:Database.Database):TableListItem[];export declare function getTableInfoSync(db:Database.Database,table:string):TableInfoData;export declare function getSchemaSync(db:Database.Database,table:string):SchemaInfo;export declare function getReferencingTablesSync(db:Database.Database,table:string):ReferencingTableInfo[];

package/dist/db/introspection.js

@@ -11,13 +11,11 @@ function listTablesSync(db) {
         .all();
     return rows.map((r) => ({ name: r.name }));
 }
-/** Get all tables non-internal in the SQLite database. */
 function getTableNames(db) {
     return db
         .prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%'")
         .all().map((r) => r.name);
 }
-/** Discover all foreign keys declared across all other tables pointing to `targetTable`. */
 function getIncomingFks(db, targetTable) {
     const refs = [];
     for (const t of getTableNames(db)) {
@@ -31,7 +29,6 @@ function getIncomingFks(db, targetTable) {
             }
         }
         catch {
-            /* ignore unreadable tables */
         }
     }
     return refs;
@@ -162,11 +159,9 @@ function getReferencingTablesSync(db, table) {
             refCount = Number(row.c);
         }
         catch {
-            /* count is best-effort */
         }
         result.push({ table: t, refs: tRefs, refCount });
     }
     result.sort((a, b) => a.table.localeCompare(b.table));
     return result;
 }
-//# sourceMappingURL=introspection.js.map

package/dist/db/manager.d.ts

@@ -1,81 +1 @@
-import type { IDatabase } from './types';
-import { type Logger } from '../utils/logger';
-export interface DbManagerOptions {
-    /** Directory of database files. Scanned for known extensions; new DBs are created here. */
-    dir?: string;
-    /** Explicit database file paths or connection strings. */
-    files?: string[];
-    /** Named database connections map (e.g. { "mydb": "postgresql://...", "name1": "postgresql://..." }). */
-    connections?: Record<string, string>;
-    /** Open every managed database read-only (no writes, no create/delete of files). */
-    readonly?: boolean;
-}
-export interface DatabaseEntry {
-    /** Stable, URL-safe id (usually the file name or connection name, deduped on collision). */
-    id: string;
-    /** Name for display. */
-    name: string;
-    /** Path on disk or sanitized connection URI. */
-    path: string;
-    /** Database dialect (sqlite or postgres). */
-    dialect: 'sqlite' | 'postgres';
-    size: number;
-    modified: string;
-    /** Whether this specific database is opened in read-only mode. */
-    readonly: boolean;
-}
-/**
- * Manages multiple SQLite database files and PostgreSQL database connections.
- *
- * Databases come from three sources:
- * - a `connections` map — named PostgreSQL or SQLite connection strings (e.g. from JSON config),
- * - a `dir` — every SQLite file with a known extension is scanned in,
- * - an explicit `files[]` array — specific file locations or connection strings.
- */
-export declare class DbManager {
-    private logger;
-    private dir?;
-    private createDir;
-    private readonly readonlyMode;
-    private files;
-    private idByPath;
-    private pathById;
-    private nameById;
-    private readonlyById;
-    private openDbs;
-    constructor(options: DbManagerOptions | string, logger?: Logger);
-    get directory(): string;
-    /** True when this manager opens every database read-only. */
-    get isReadOnly(): boolean;
-    isDbFile(name: string): boolean;
-    private registerConnections;
-    private registerDirFiles;
-    private registerExplicitFiles;
-    private addNamedTarget;
-    private addFile;
-    /** List all managed databases (metadata only — does not open them). */
-    list(): DatabaseEntry[];
-    has(id: string): boolean;
-    /** True if global manager is in readonly mode or this database is explicitly marked read-only. */
-    isDbReadOnly(id: string): boolean;
-    /** Set or toggle read-only mode for a specific database id. */
-    setReadonly(id: string, readonly: boolean): void;
-    /** Open (and cache) a database by id; creates the file if it is new SQLite database. */
-    open(id: string, readonlyOverride?: boolean): IDatabase;
-    /**
-     * Register and open an existing database file by path, returning its id.
-     * Used by the "Open an existing database" file browser. Validates that the
-     * file is a readable SQLite database before keeping it registered.
-     */
-    openFile(absPath: string, readonly?: boolean): string;
-    get(id: string): IDatabase | undefined;
-    /** Count the tables in a database (opens it if necessary). */
-    countTables(id: string): Promise<number>;
-    /** Create a new (empty) SQLite database. Returns its id. */
-    create(name: string): string;
-    /** Dynamically register a named PostgreSQL or SQLite connection string. Returns its id. */
-    addConnection(name: string, connectionString: string, readonly?: boolean): string;
-    /** Close and delete a database file (including WAL/SHM sidecars). */
-    remove(id: string): void;
-    closeAll(): void;
-}
+import type {IDatabase} from './types';import{type Logger} from '../utils/logger';export interface DbManagerOptions{dir?:string;files?:string[];connections?:Record<string,string>;readonly ?:boolean;}export interface DatabaseEntry{id:string;name:string;path:string;dialect:'sqlite'|'postgres';size:number;modified:string;readonly :boolean;}export declare class DbManager{private logger;private dir?;private createDir;private readonly readonlyMode;private files;private idByPath;private pathById;private nameById;private readonlyById;private openDbs;constructor(options:DbManagerOptions|string,logger?:Logger);get directory():string;get isReadOnly():boolean;isDbFile(name:string):boolean;private registerConnections;private registerDirFiles;private registerExplicitFiles;private addNamedTarget;private addFile;list():DatabaseEntry[];has(id:string):boolean;isDbReadOnly(id:string):boolean;setReadonly(id:string,readonly :boolean):void;open(id:string,readonlyOverride?:boolean):IDatabase;openFile(absPath:string,readonly ?:boolean):string;get(id:string):IDatabase|undefined;countTables(id:string):Promise<number>;create(name:string):string;addConnection(name:string,connectionString:string,readonly ?:boolean):string;remove(id:string):void;closeAll():void;}