admindb 2.0.0 → 2.1.1

package/dist/db/filters.js

@@ -1,158 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.escapeLike = escapeLike;
-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) {
-        case 'eq':
-            conds.push(`${quotedCol} = ?`);
-            params.push(value);
-            break;
-        case 'neq':
-            conds.push(`${quotedCol} != ?`);
-            params.push(value);
-            break;
-        case 'gt':
-            conds.push(`${quotedCol} > ?`);
-            params.push(value);
-            break;
-        case 'gte':
-            conds.push(`${quotedCol} >= ?`);
-            params.push(value);
-            break;
-        case 'lt':
-            conds.push(`${quotedCol} < ?`);
-            params.push(value);
-            break;
-        case 'lte':
-            conds.push(`${quotedCol} <= ?`);
-            params.push(value);
-            break;
-        case 'like':
-            conds.push(`${quotedCol} LIKE ? ESCAPE '\\'`);
-            params.push('%' + escapeLike(value) + '%');
-            break;
-        case 'prefix':
-            conds.push(`${quotedCol} LIKE ? ESCAPE '\\'`);
-            params.push(escapeLike(value) + '%');
-            break;
-        case 'between':
-            conds.push(`${quotedCol} >= ?`);
-            params.push(value);
-            conds.push(`${quotedCol} <= ?`);
-            params.push(String(c.max ?? ''));
-            break;
-        case 'null':
-            conds.push(`${quotedCol} IS NULL`);
-            break;
-        case 'notnull':
-            conds.push(`${quotedCol} IS NOT NULL`);
-            break;
-        default:
-            break;
-    }
-}
-function buildFilterClause(filters, availableCols) {
-    const conds = [];
-    const params = [];
-    const colSet = new Set(availableCols);
-    for (const [col, raw] of Object.entries(filters ?? {})) {
-        if (!colSet.has(col))
-            continue;
-        const q = (0, generator_1.quoteIdentifier)(col);
-        if (Array.isArray(raw)) {
-            for (const c of raw) {
-                if (c && typeof c === 'object')
-                    pushFilterCondition(conds, params, q, c);
-            }
-            continue;
-        }
-        if (raw && typeof raw === 'object') {
-            pushFilterCondition(conds, params, q, raw);
-            continue;
-        }
-        // Legacy string syntax.
-        const value = String(raw ?? '').trim();
-        if (value === '')
-            continue;
-        if (value.startsWith('>=')) {
-            conds.push(`${q} >= ?`);
-            params.push(value.slice(2).trim());
-        }
-        else if (value.startsWith('<=')) {
-            conds.push(`${q} <= ?`);
-            params.push(value.slice(2).trim());
-        }
-        else if (value.startsWith('!=')) {
-            conds.push(`${q} != ?`);
-            params.push(value.slice(2).trim());
-        }
-        else if (value.startsWith('=')) {
-            conds.push(`${q} = ?`);
-            params.push(value.slice(1).trim());
-        }
-        else if (value.startsWith('>')) {
-            conds.push(`${q} > ?`);
-            params.push(value.slice(1).trim());
-        }
-        else if (value.startsWith('<')) {
-            conds.push(`${q} < ?`);
-            params.push(value.slice(1).trim());
-        }
-        else if (value.endsWith('*')) {
-            conds.push(`${q} LIKE ? ESCAPE '\\'`);
-            params.push(escapeLike(value.slice(0, -1)) + '%');
-        }
-        else {
-            conds.push(`${q} LIKE ? ESCAPE '\\'`);
-            params.push('%' + escapeLike(value) + '%');
-        }
-    }
-    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;
-    let result = '';
-    for (let i = 0; i < sql.length; i++) {
-        const ch = sql[i];
-        if (ch === "'") {
-            if (inString && sql[i + 1] === "'") {
-                result += "''";
-                i++;
-                continue;
-            }
-            inString = !inString;
-            result += ch;
-        }
-        else if (ch === '?' && !inString) {
-            result += `$${idx++}`;
-        }
-        else {
-            result += ch;
-        }
-    }
-    return result;
-}
-//# sourceMappingURL=filters.js.map
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.escapeLike=escapeLike,exports.pushFilterCondition=pushFilterCondition,exports.buildFilterClause=function(filters,availableCols){const conds=[],params=[],colSet=new Set(availableCols);for(const[col,raw]of Object.entries(filters??{})){if(!colSet.has(col))continue;const q=(0,generator_1.quoteIdentifier)(col);if(Array.isArray(raw)){for(const c of raw)c&&"object"==typeof c&&pushFilterCondition(conds,params,q,c);continue}if(raw&&"object"==typeof raw){pushFilterCondition(conds,params,q,raw);continue}const value=String(raw??"").trim();""!==value&&(value.startsWith(">=")?(conds.push(`${q} >= ?`),params.push(value.slice(2).trim())):value.startsWith("<=")?(conds.push(`${q} <= ?`),params.push(value.slice(2).trim())):value.startsWith("!=")?(conds.push(`${q} != ?`),params.push(value.slice(2).trim())):value.startsWith("=")?(conds.push(`${q} = ?`),params.push(value.slice(1).trim())):value.startsWith(">")?(conds.push(`${q} > ?`),params.push(value.slice(1).trim())):value.startsWith("<")?(conds.push(`${q} < ?`),params.push(value.slice(1).trim())):value.endsWith("*")?(conds.push(`${q} LIKE ? ESCAPE '\\'`),params.push(escapeLike(value.slice(0,-1))+"%")):(conds.push(`${q} LIKE ? ESCAPE '\\'`),params.push("%"+escapeLike(value)+"%")))}return{where:conds.length?` WHERE ${conds.join(" AND ")}`:"",params:params}},exports.convertPlaceholdersToPostgres=function(sql,startIdx=1){let idx=startIdx,inString=!1,result="";for(let i=0;i<sql.length;i++){const ch=sql[i];if("'"===ch){if(inString&&"'"===sql[i+1]){result+="''",i++;continue}inString=!inString,result+=ch}else result+="?"!==ch||inString?ch:"$"+idx++}return result};const generator_1=require("../sql/generator");function escapeLike(s){return String(s).replace(/[\\%_]/g,m=>"\\"+m)}function pushFilterCondition(conds,params,quotedCol,c){const value=String(c.value??"");switch(c.op){case"eq":conds.push(`${quotedCol} = ?`),params.push(value);break;case"neq":conds.push(`${quotedCol} != ?`),params.push(value);break;case"gt":conds.push(`${quotedCol} > ?`),params.push(value);break;case"gte":conds.push(`${quotedCol} >= ?`),params.push(value);break;case"lt":conds.push(`${quotedCol} < ?`),params.push(value);break;case"lte":conds.push(`${quotedCol} <= ?`),params.push(value);break;case"like":conds.push(`${quotedCol} LIKE ? ESCAPE '\\'`),params.push("%"+escapeLike(value)+"%");break;case"prefix":conds.push(`${quotedCol} LIKE ? ESCAPE '\\'`),params.push(escapeLike(value)+"%");break;case"between":conds.push(`${quotedCol} >= ?`),params.push(value),conds.push(`${quotedCol} <= ?`),params.push(String(c.max??""));break;case"null":conds.push(`${quotedCol} IS NULL`);break;case"notnull":conds.push(`${quotedCol} IS NOT NULL`)}}

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

@@ -1,25 +1 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./types"), exports);
-__exportStar(require("./filters"), exports);
-__exportStar(require("./introspection"), exports);
-__exportStar(require("./migrations"), exports);
-__exportStar(require("./database"), exports);
-__exportStar(require("./postgres"), exports);
-__exportStar(require("./manager"), exports);
-__exportStar(require("./export"), exports);
-//# sourceMappingURL=index.js.map
+var __createBinding=this&&this.__createBinding||(Object.create?function(o,m,k,k2){void 0===k2&&(k2=k);var desc=Object.getOwnPropertyDescriptor(m,k);desc&&!("get"in desc?!m.__esModule:desc.writable||desc.configurable)||(desc={enumerable:!0,get:function(){return m[k]}}),Object.defineProperty(o,k2,desc)}:function(o,m,k,k2){void 0===k2&&(k2=k),o[k2]=m[k]}),__exportStar=this&&this.__exportStar||function(m,exports){for(var p in m)"default"===p||Object.prototype.hasOwnProperty.call(exports,p)||__createBinding(exports,m,p)};Object.defineProperty(exports,"__esModule",{value:!0}),__exportStar(require("./types"),exports),__exportStar(require("./filters"),exports),__exportStar(require("./introspection"),exports),__exportStar(require("./migrations"),exports),__exportStar(require("./database"),exports),__exportStar(require("./postgres"),exports),__exportStar(require("./manager"),exports),__exportStar(require("./export"),exports);

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

@@ -1,172 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.listTablesSync = listTablesSync;
-exports.getTableInfoSync = getTableInfoSync;
-exports.getSchemaSync = getSchemaSync;
-exports.getReferencingTablesSync = getReferencingTablesSync;
-const generator_1 = require("../sql/generator");
-function listTablesSync(db) {
-    const rows = db
-        .prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%' ORDER BY name")
-        .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)) {
-        if (t === targetTable)
-            continue;
-        try {
-            const fks = db.prepare(`PRAGMA foreign_key_list(${(0, generator_1.quoteIdentifier)(t)})`).all();
-            for (const fk of fks) {
-                if (fk.table === targetTable)
-                    refs.push({ table: t, from: fk.from, to: fk.to ?? '' });
-            }
-        }
-        catch {
-            /* ignore unreadable tables */
-        }
-    }
-    return refs;
-}
-function getTableInfoSync(db, table) {
-    const cols = db.prepare(`PRAGMA table_info(${(0, generator_1.quoteIdentifier)(table)})`).all();
-    const fks = db.prepare(`PRAGMA foreign_key_list(${(0, generator_1.quoteIdentifier)(table)})`).all();
-    const primaryKey = cols
-        .filter((c) => c.pk > 0)
-        .sort((a, b) => a.pk - b.pk)
-        .map((c) => c.name);
-    const indexRows = db
-        .prepare(`PRAGMA index_list(${(0, generator_1.quoteIdentifier)(table)})`)
-        .all();
-    const indexes = indexRows.map((ix) => {
-        const ixCols = db
-            .prepare(`PRAGMA index_info(${(0, generator_1.quoteIdentifier)(ix.name)})`)
-            .all().map((c) => c.name);
-        const sqlRow = db
-            .prepare("SELECT sql FROM sqlite_master WHERE type = 'index' AND name = ?")
-            .get(ix.name);
-        return {
-            name: ix.name,
-            unique: !!ix.unique,
-            partial: ix.partial,
-            origin: ix.origin,
-            columns: ixCols,
-            sql: sqlRow?.sql ?? null,
-        };
-    });
-    const ddlRow = db
-        .prepare("SELECT sql FROM sqlite_master WHERE type = 'table' AND name = ?")
-        .get(table);
-    return {
-        table,
-        columns: cols.map((c) => ({
-            cid: c.cid,
-            name: c.name,
-            type: c.type,
-            notnull: c.notnull,
-            dflt_value: c.dflt_value,
-            pk: c.pk,
-        })),
-        foreignKeys: fks.map((f) => ({
-            id: f.id,
-            seq: f.seq,
-            table: f.table,
-            from: f.from,
-            to: f.to,
-            on_update: f.on_update,
-            on_delete: f.on_delete,
-        })),
-        primaryKey,
-        indexes,
-        sql: ddlRow?.sql ?? null,
-    };
-}
-function getSchemaSync(db, table) {
-    const info = getTableInfoSync(db, table);
-    if (!info || info.columns.length === 0)
-        throw new Error(`Table "${table}" does not exist.`);
-    const foreignKeys = info.foreignKeys;
-    const indexes = info.indexes;
-    const uniqueCols = new Set();
-    const indexedCols = new Set();
-    for (const ix of indexes) {
-        if (ix.unique)
-            ix.columns.forEach((c) => uniqueCols.add(c));
-        if (ix.origin === 'c')
-            ix.columns.forEach((c) => indexedCols.add(c));
-    }
-    const refs = getIncomingFks(db, table);
-    const refsByTo = new Map();
-    for (const r of refs) {
-        const arr = refsByTo.get(r.to) ?? [];
-        arr.push({ table: r.table, from: r.from });
-        refsByTo.set(r.to, arr);
-    }
-    const fkByFrom = new Map(foreignKeys.map((fk) => [fk.from, fk]));
-    const columns = info.columns.map((c) => {
-        const unique = c.pk > 0 || uniqueCols.has(c.name);
-        const indexed = indexedCols.has(c.name);
-        const referencedBy = refsByTo.get(c.name) ?? [];
-        const fk = fkByFrom.get(c.name) ?? null;
-        const dropBlockers = [];
-        if (c.pk > 0)
-            dropBlockers.push('Is part of the primary key');
-        if (unique && c.pk === 0)
-            dropBlockers.push('Has a UNIQUE constraint');
-        if (indexed)
-            dropBlockers.push('Is used by an index');
-        if (referencedBy.length)
-            dropBlockers.push(`Referenced by a foreign key in "${referencedBy[0].table}"`);
-        if (fk)
-            dropBlockers.push('Is part of a foreign key');
-        return {
-            ...c,
-            unique,
-            indexed,
-            referencedBy,
-            fk,
-            canDrop: dropBlockers.length === 0,
-            dropBlockers,
-        };
-    });
-    return {
-        table,
-        columns,
-        foreignKeys,
-        indexes,
-        references: refs,
-    };
-}
-function getReferencingTablesSync(db, table) {
-    const refs = getIncomingFks(db, table);
-    const byTable = new Map();
-    for (const r of refs) {
-        const arr = byTable.get(r.table) ?? [];
-        arr.push({ from: r.from, to: r.to });
-        byTable.set(r.table, arr);
-    }
-    const result = [];
-    for (const [t, tRefs] of byTable) {
-        let refCount = 0;
-        try {
-            const conds = tRefs.map((r) => `${(0, generator_1.quoteIdentifier)(r.from)} IS NOT NULL`);
-            const row = db.prepare(`SELECT COUNT(*) AS c FROM ${(0, generator_1.quoteIdentifier)(t)} WHERE ${conds.join(' OR ')}`).get();
-            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
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.listTablesSync=function(db){return db.prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%' ORDER BY name").all().map(r=>({name:r.name}))},exports.getTableInfoSync=getTableInfoSync,exports.getSchemaSync=function(db,table){const info=getTableInfoSync(db,table);if(!info||0===info.columns.length)throw new Error(`Table "${table}" does not exist.`);const foreignKeys=info.foreignKeys,indexes=info.indexes,uniqueCols=new Set,indexedCols=new Set;for(const ix of indexes)ix.unique&&ix.columns.forEach(c=>uniqueCols.add(c)),"c"===ix.origin&&ix.columns.forEach(c=>indexedCols.add(c));const refs=getIncomingFks(db,table),refsByTo=new Map;for(const r of refs){const arr=refsByTo.get(r.to)??[];arr.push({table:r.table,from:r.from}),refsByTo.set(r.to,arr)}const fkByFrom=new Map(foreignKeys.map(fk=>[fk.from,fk])),columns=info.columns.map(c=>{const unique=c.pk>0||uniqueCols.has(c.name),indexed=indexedCols.has(c.name),referencedBy=refsByTo.get(c.name)??[],fk=fkByFrom.get(c.name)??null,dropBlockers=[];return c.pk>0&&dropBlockers.push("Is part of the primary key"),unique&&0===c.pk&&dropBlockers.push("Has a UNIQUE constraint"),indexed&&dropBlockers.push("Is used by an index"),referencedBy.length&&dropBlockers.push(`Referenced by a foreign key in "${referencedBy[0].table}"`),fk&&dropBlockers.push("Is part of a foreign key"),{...c,unique:unique,indexed:indexed,referencedBy:referencedBy,fk:fk,canDrop:0===dropBlockers.length,dropBlockers:dropBlockers}});return{table:table,columns:columns,foreignKeys:foreignKeys,indexes:indexes,references:refs}},exports.getReferencingTablesSync=function(db,table){const refs=getIncomingFks(db,table),byTable=new Map;for(const r of refs){const arr=byTable.get(r.table)??[];arr.push({from:r.from,to:r.to}),byTable.set(r.table,arr)}const result=[];for(const[t,tRefs]of byTable){let refCount=0;try{const conds=tRefs.map(r=>`${(0,generator_1.quoteIdentifier)(r.from)} IS NOT NULL`),row=db.prepare(`SELECT COUNT(*) AS c FROM ${(0,generator_1.quoteIdentifier)(t)} WHERE ${conds.join(" OR ")}`).get();refCount=Number(row.c)}catch{}result.push({table:t,refs:tRefs,refCount:refCount})}return result.sort((a,b)=>a.table.localeCompare(b.table)),result};const generator_1=require("../sql/generator");function getIncomingFks(db,targetTable){const refs=[];for(const t of function(db){return db.prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%'").all().map(r=>r.name)}(db))if(t!==targetTable)try{const fks=db.prepare(`PRAGMA foreign_key_list(${(0,generator_1.quoteIdentifier)(t)})`).all();for(const fk of fks)fk.table===targetTable&&refs.push({table:t,from:fk.from,to:fk.to??""})}catch{}return refs}function getTableInfoSync(db,table){const cols=db.prepare(`PRAGMA table_info(${(0,generator_1.quoteIdentifier)(table)})`).all(),fks=db.prepare(`PRAGMA foreign_key_list(${(0,generator_1.quoteIdentifier)(table)})`).all(),primaryKey=cols.filter(c=>c.pk>0).sort((a,b)=>a.pk-b.pk).map(c=>c.name),indexes=db.prepare(`PRAGMA index_list(${(0,generator_1.quoteIdentifier)(table)})`).all().map(ix=>{const ixCols=db.prepare(`PRAGMA index_info(${(0,generator_1.quoteIdentifier)(ix.name)})`).all().map(c=>c.name),sqlRow=db.prepare("SELECT sql FROM sqlite_master WHERE type = 'index' AND name = ?").get(ix.name);return{name:ix.name,unique:!!ix.unique,partial:ix.partial,origin:ix.origin,columns:ixCols,sql:sqlRow?.sql??null}}),ddlRow=db.prepare("SELECT sql FROM sqlite_master WHERE type = 'table' AND name = ?").get(table);return{table:table,columns:cols.map(c=>({cid:c.cid,name:c.name,type:c.type,notnull:c.notnull,dflt_value:c.dflt_value,pk:c.pk})),foreignKeys:fks.map(f=>({id:f.id,seq:f.seq,table:f.table,from:f.from,to:f.to,on_update:f.on_update,on_delete:f.on_delete})),primaryKey:primaryKey,indexes:indexes,sql:ddlRow?.sql??null}}

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;}