admindb 2.1.1 → 2.2.1

package/dist/db/database.js

@@ -1 +1,477 @@
-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)},__importDefault=this&&this.__importDefault||function(mod){return mod&&mod.__esModule?mod:{default:mod}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.SqliteDatabase=void 0;const better_sqlite3_1=__importDefault(require("better-sqlite3")),generator_1=require("../sql/generator"),common_1=require("../utils/common"),types_1=require("./types"),filters_1=require("./filters"),introspection_1=require("./introspection"),migrations_1=require("./migrations");__exportStar(require("./types"),exports),__exportStar(require("./filters"),exports);exports.SqliteDatabase=class{db;logger;path;isReadOnly;dialect="sqlite";constructor(dbPath,logger,options={}){this.path=dbPath,this.logger=logger,this.isReadOnly=!!options.readonly,this.db=new better_sqlite3_1.default(dbPath,{readonly:this.isReadOnly}),this.db.exec("PRAGMA foreign_keys = ON;"),this.isReadOnly?this.db.exec("PRAGMA query_only = ON;"):(this.db.exec("PRAGMA journal_mode = WAL;"),this.initSchema()),this.logger.info(`Opened SQLite database at ${dbPath}${this.isReadOnly?" (read-only)":""}`)}readonlyBlocked(){return{success:!1,error:"Database is open in read-only mode — write operations are disabled."}}close(){try{this.db.close()}catch(err){this.logger.warn(`Failed to close database: ${(0,common_1.errorMessage)(err)}`)}}initSchema(){this.db.exec(`\n      CREATE TABLE IF NOT EXISTS ${(0,generator_1.quoteIdentifier)(types_1.INTERNAL_TABLES.savedQueries)} (\n        ${(0,generator_1.quoteIdentifier)("id")} INTEGER PRIMARY KEY AUTOINCREMENT,\n        ${(0,generator_1.quoteIdentifier)("name")} TEXT NOT NULL UNIQUE,\n        ${(0,generator_1.quoteIdentifier)("sql")} TEXT NOT NULL,\n        ${(0,generator_1.quoteIdentifier)("created_at")} TEXT NOT NULL DEFAULT (datetime('now'))\n      );\n    `)}async tryRun(fn){try{return{success:!0,data:await Promise.resolve(fn())}}catch(err){const msg=(0,common_1.errorMessage)(err);return this.logger.error(msg),{success:!1,error:msg}}}transaction(fn){return this.isReadOnly?Promise.resolve(this.readonlyBlocked()):this.tryRun(()=>{this.db.exec("BEGIN");try{const res=fn();return this.db.exec("COMMIT"),res}catch(err){try{this.db.exec("ROLLBACK")}catch{}throw err}})}toBind(value){return void 0===value?null:"boolean"==typeof value?value?1:0:(value instanceof Uint8Array||Buffer.isBuffer(value),value)}async all(sql,params=[]){return this.tryRun(()=>this.db.prepare(sql).all(...params))}async run(sql,params=[]){return this.isReadOnly?this.readonlyBlocked():this.tryRun(()=>{const info=this.db.prepare(sql).run(...params);return{changes:Number(info.changes),lastInsertRowid:void 0===info.lastInsertRowid||null===info.lastInsertRowid?null:Number(info.lastInsertRowid)}})}async execResult(sql){return this.isReadOnly?this.readonlyBlocked():this.tryRun(()=>(this.db.exec(sql),{changes:void 0}))}hasMultipleStatements(sql){const s=String(sql??"").trim();if(!s)return!1;try{return this.db.prepare(s),!1}catch(err){return/more than one statement/i.test((0,common_1.errorMessage)(err))}}async runWrite(sql){if(this.isReadOnly)return this.readonlyBlocked();const trimmed=String(sql).trim().replace(/;+\s*$/,"");try{const info=this.db.prepare(trimmed).run();return{success:!0,data:{changes:Number(info.changes)}}}catch{try{return this.db.exec(String(sql)),{success:!0,data:{changes:void 0}}}catch(err2){const msg=(0,common_1.errorMessage)(err2);return this.logger.error(msg),{success:!1,error:msg}}}}async listTables(){return this.tryRun(()=>(0,introspection_1.listTablesSync)(this.db))}async getTableInfo(table){return this.tryRun(()=>(0,introspection_1.getTableInfoSync)(this.db,table))}async getRowCount(table,filters){return this.tryRun(()=>{const info=this.getTableInfoSync(table),{where:where,params:params}=(0,filters_1.buildFilterClause)(filters,info?.columns.map(c=>c.name)??[]),row=this.db.prepare(`SELECT COUNT(*) AS c FROM ${(0,generator_1.quoteIdentifier)(table)}${where}`).get(...params);return Number(row.c)})}async getRows(table,opts={}){return this.tryRun(()=>{const info=this.getTableInfoSync(table),cols=info?.columns??[],orderCol=opts.orderBy||info?.primaryKey?.[0]||cols[0]?.name,orderDir="desc"===opts.orderDir?"DESC":"ASC",limit=opts.limit&&opts.limit>0?opts.limit:200,offset=((opts.page&&opts.page>0?opts.page:1)-1)*limit,{where:where,params:params}=(0,filters_1.buildFilterClause)(opts.filters,cols.map(c=>c.name));let sql=`SELECT rowid AS _rowid_, * FROM ${(0,generator_1.quoteIdentifier)(table)}${where}`;return orderCol&&(sql+=` ORDER BY ${(0,generator_1.quoteIdentifier)(orderCol)} ${orderDir}`),sql+=` LIMIT ${limit} OFFSET ${offset}`,this.db.prepare(sql).all(...params)})}async getAllRows(table){return this.tryRun(()=>this.db.prepare(`SELECT rowid AS _rowid_, * FROM ${(0,generator_1.quoteIdentifier)(table)}`).all())}async getRow(table,where){return this.tryRun(()=>{const conds=where.map(w=>`${(0,generator_1.quoteIdentifier)(w.column)} = ?`),sql=`SELECT rowid AS _rowid_, * FROM ${(0,generator_1.quoteIdentifier)(table)} WHERE ${conds.join(" AND ")} LIMIT 1`,row=this.db.prepare(sql).get(...where.map(w=>this.toBind(w.value)));return row||null})}async insertRow(table,fields){const cols=fields.map(f=>(0,generator_1.quoteIdentifier)(f.column)),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)))}async insertRows(table,rows){return this.transaction(()=>{let inserted=0;for(const fields of rows){if(!fields.length)continue;const cols=fields.map(f=>(0,generator_1.quoteIdentifier)(f.column)),sql=`INSERT INTO ${(0,generator_1.quoteIdentifier)(table)} (${cols.join(", ")}) VALUES (${fields.map(()=>"?").join(", ")})`;this.db.prepare(sql).run(...fields.map(f=>this.toBind(f.value))),inserted+=1}return{inserted:inserted,skipped:rows.length-inserted}})}async updateRow(table,fields,where){const sets=fields.map(f=>`${(0,generator_1.quoteIdentifier)(f.column)} = ?`),conds=where.map(w=>`${(0,generator_1.quoteIdentifier)(w.column)} = ?`),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))])}async updateRows(table,rows){return this.transaction(()=>{let updated=0;for(const{fields:fields,where:where}of rows){if(!fields.length||!where.length)continue;const sets=fields.map(f=>`${(0,generator_1.quoteIdentifier)(f.column)} = ?`),conds=where.map(w=>`${(0,generator_1.quoteIdentifier)(w.column)} = ?`),sql=`UPDATE ${(0,generator_1.quoteIdentifier)(table)} SET ${sets.join(", ")} WHERE ${conds.join(" AND ")}`,info=this.db.prepare(sql).run(...fields.map(f=>this.toBind(f.value)),...where.map(w=>this.toBind(w.value)));updated+=Number(info.changes)}return{updated:updated}})}async deleteRow(table,where){const conds=where.map(w=>`${(0,generator_1.quoteIdentifier)(w.column)} = ?`),sql=`DELETE FROM ${(0,generator_1.quoteIdentifier)(table)} WHERE ${conds.join(" AND ")}`;return this.run(sql,where.map(w=>this.toBind(w.value)))}async deleteRows(table,rows){return this.transaction(()=>{let deleted=0;for(const where of rows){if(!where.length)continue;const conds=where.map(w=>`${(0,generator_1.quoteIdentifier)(w.column)} = ?`),sql=`DELETE FROM ${(0,generator_1.quoteIdentifier)(table)} WHERE ${conds.join(" AND ")}`,info=this.db.prepare(sql).run(...where.map(w=>this.toBind(w.value)));deleted+=Number(info.changes)}return{deleted:deleted}})}async getRowsByPks(table,pks){return this.tryRun(()=>{const groups=[],params=[];for(const where of pks)where.length&&(groups.push(where.map(w=>`${(0,generator_1.quoteIdentifier)(w.column)} = ?`).join(" AND ")),params.push(...where.map(w=>this.toBind(w.value))));if(!groups.length)return[];const sql=`SELECT rowid AS _rowid_, * FROM ${(0,generator_1.quoteIdentifier)(table)} WHERE ${groups.map(g=>`(${g})`).join(" OR ")}`;return this.db.prepare(sql).all(...params)})}async getCreateStatement(table){return this.tryRun(()=>{const row=this.db.prepare("SELECT sql FROM sqlite_master WHERE type = 'table' AND name = ?").get(table);return row?.sql??null})}async listSavedQueries(){return this.all(`SELECT id, name, sql, created_at FROM ${(0,generator_1.quoteIdentifier)(types_1.INTERNAL_TABLES.savedQueries)} ORDER BY name COLLATE NOCASE`)}async saveQuery(name,sql){return this.run(`INSERT INTO ${(0,generator_1.quoteIdentifier)(types_1.INTERNAL_TABLES.savedQueries)} (name, sql) VALUES (?, ?)`,[name,sql])}async deleteSavedQuery(id){return this.run(`DELETE FROM ${(0,generator_1.quoteIdentifier)(types_1.INTERNAL_TABLES.savedQueries)} WHERE id = ?`,[Number(id)])}async getSchema(table){return this.tryRun(()=>(0,introspection_1.getSchemaSync)(this.db,table))}async getReferencingTables(table){return this.tryRun(()=>(0,introspection_1.getReferencingTablesSync)(this.db,table))}async getRowsByFk(table,column,value,limit=50){return this.tryRun(()=>{const n=Math.max(1,Math.min(500,Number(limit)||50)),countRow=this.db.prepare(`SELECT COUNT(*) AS c FROM ${(0,generator_1.quoteIdentifier)(table)} WHERE ${(0,generator_1.quoteIdentifier)(column)} = ?`).get(value);return{rows:this.db.prepare(`SELECT * FROM ${(0,generator_1.quoteIdentifier)(table)} WHERE ${(0,generator_1.quoteIdentifier)(column)} = ? LIMIT ${n}`).all(value),total:Number(countRow.c)}})}async renameTable(oldName,newName){return this.execResult((0,generator_1.generateRenameTable)(oldName,newName))}async addColumn(table,col){return this.isReadOnly?this.readonlyBlocked():this.tryRun(()=>{if(col.primaryKey)return(0,migrations_1.modifyTableStructureSync)(this.db,table,existingCols=>[...existingCols,col]);try{const colCopy={...col,unique:!1},sql=(0,generator_1.generateAddColumn)(table,colCopy);if(this.db.exec(sql),col.unique){const idxName=`idx_${table}_${col.name}_unique`;this.db.exec(`CREATE UNIQUE INDEX IF NOT EXISTS ${(0,generator_1.quoteIdentifier)(idxName)} ON ${(0,generator_1.quoteIdentifier)(table)} (${(0,generator_1.quoteIdentifier)(col.name)});`)}return{changes:1}}catch{return(0,migrations_1.modifyTableStructureSync)(this.db,table,existingCols=>[...existingCols,col])}})}async modifyColumn(table,oldColName,newColDef){return this.isReadOnly?this.readonlyBlocked():this.tryRun(()=>{const newName=String(newColDef.name||oldColName).trim(),existing=this.db.prepare(`PRAGMA table_info(${(0,generator_1.quoteIdentifier)(table)})`).all().find(c=>c.name===oldColName);if(!existing)throw new Error(`Column "${oldColName}" does not exist in table "${table}".`);const existingFk=this.db.prepare(`PRAGMA foreign_key_list(${(0,generator_1.quoteIdentifier)(table)})`).all().find(f=>f.from===oldColName),indexRows=this.db.prepare(`PRAGMA index_list(${(0,generator_1.quoteIdentifier)(table)})`).all();let existingIsUnique=!1;for(const ix of indexRows)if(ix.unique){const ixCols=this.db.prepare(`PRAGMA index_info(${(0,generator_1.quoteIdentifier)(ix.name)})`).all().map(c=>c.name);if(1===ixCols.length&&ixCols[0]===oldColName){existingIsUnique=!0;break}}const typeMatches=!newColDef.type||newColDef.type.toUpperCase()===existing.type.toUpperCase(),pkMatches=void 0===newColDef.primaryKey||newColDef.primaryKey===existing.pk>0,notNullMatches=void 0===newColDef.notNull||newColDef.notNull===!!existing.notnull,uniqueMatches=void 0===newColDef.unique||newColDef.unique===existingIsUnique,defaultMatches=void 0===newColDef.defaultValue||String(newColDef.defaultValue??"").trim()===String(existing.dflt_value??"").trim(),fkMatches=void 0===newColDef.foreignKey||!newColDef.foreignKey&&!existingFk||newColDef.foreignKey&&existingFk&&newColDef.foreignKey.table===existingFk.table&&newColDef.foreignKey.column===existingFk.to;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));for(const suffix of["","_unique"]){const defaultOldIdx=`idx_${table}_${oldColName}${suffix}`;if(existingIdxNames.has(defaultOldIdx)){const newIdxName=`idx_${table}_${newName}${suffix}`,uniqueKeyword="_unique"===suffix?"UNIQUE ":"";try{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{}}}return{changes:1}}return oldColName===newName&&typeMatches&&pkMatches&&notNullMatches&&uniqueMatches&&defaultMatches&&fkMatches?{changes:0}:(0,migrations_1.modifyTableStructureSync)(this.db,table,cols=>{const idx=cols.findIndex(c=>c.name===oldColName);if(-1===idx)throw new Error(`Column "${oldColName}" does not exist in table "${table}".`);const updated=[...cols];return updated[idx]={...updated[idx],name:newName,type:newColDef.type||updated[idx].type,primaryKey:void 0!==newColDef.primaryKey?newColDef.primaryKey:updated[idx].primaryKey,notNull:void 0!==newColDef.notNull?newColDef.notNull:updated[idx].notNull,unique:void 0!==newColDef.unique?newColDef.unique:updated[idx].unique,defaultValue:void 0!==newColDef.defaultValue?newColDef.defaultValue:updated[idx].defaultValue,foreignKey:void 0!==newColDef.foreignKey?newColDef.foreignKey:updated[idx].foreignKey},updated},oldColName,newName)})}async renameColumn(table,oldName,newName){return this.isReadOnly?this.readonlyBlocked():this.tryRun(()=>{this.db.exec((0,generator_1.generateRenameColumn)(table,oldName,newName));const indexRows=this.db.prepare(`PRAGMA index_list(${(0,generator_1.quoteIdentifier)(table)})`).all(),existingIdxNames=new Set(indexRows.map(i=>i.name));for(const suffix of["","_unique"]){const defaultOldIdx=`idx_${table}_${oldName}${suffix}`;if(existingIdxNames.has(defaultOldIdx)){const newIdxName=`idx_${table}_${newName}${suffix}`,uniqueKeyword="_unique"===suffix?"UNIQUE ":"";try{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{}}}return{changes:1}})}async dropColumn(table,column){return this.execResult((0,generator_1.generateDropColumn)(table,column))}async dropTable(table){return this.execResult((0,generator_1.generateDropTable)(table))}async createIndex(table,index){return this.execResult((0,generator_1.generateCreateIndex)(table,index))}async dropIndex(indexName){return this.execResult((0,generator_1.generateDropIndex)(indexName))}getTableInfoSync(table){try{const cols=this.db.prepare(`PRAGMA table_info(${(0,generator_1.quoteIdentifier)(table)})`).all();if(!cols.length)return null;const primaryKey=cols.filter(c=>c.pk>0).sort((a,b)=>a.pk-b.pk).map(c=>c.name);return{table:table,columns:cols,foreignKeys:[],primaryKey:primaryKey,indexes:[],sql:null}}catch{return null}}};
+"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);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteDatabase = void 0;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const generator_1 = require("../sql/generator");
+const common_1 = require("../utils/common");
+const types_1 = require("./types");
+const filters_1 = require("./filters");
+const introspection_1 = require("./introspection");
+const migrations_1 = require("./migrations");
+__exportStar(require("./types"), exports);
+__exportStar(require("./filters"), exports);
+class SqliteDatabase {
+    db;
+    logger;
+    path;
+    isReadOnly;
+    dialect = 'sqlite';
+    constructor(dbPath, logger, options = {}) {
+        this.path = dbPath;
+        this.logger = logger;
+        this.isReadOnly = !!options.readonly;
+        this.db = new better_sqlite3_1.default(dbPath, { readonly: this.isReadOnly });
+        this.db.exec('PRAGMA foreign_keys = ON;');
+        if (this.isReadOnly) {
+            this.db.exec('PRAGMA query_only = ON;');
+        }
+        else {
+            this.db.exec('PRAGMA journal_mode = WAL;');
+            this.initSchema();
+        }
+        this.logger.info(`Opened SQLite database at ${dbPath}${this.isReadOnly ? ' (read-only)' : ''}`);
+    }
+    readonlyBlocked() {
+        return { success: false, error: 'Database is open in read-only mode — write operations are disabled.' };
+    }
+    close() {
+        try {
+            this.db.close();
+        }
+        catch (err) {
+            this.logger.warn(`Failed to close database: ${(0, common_1.errorMessage)(err)}`);
+        }
+    }
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS ${(0, generator_1.quoteIdentifier)(types_1.INTERNAL_TABLES.savedQueries)} (
+        ${(0, generator_1.quoteIdentifier)('id')} INTEGER PRIMARY KEY AUTOINCREMENT,
+        ${(0, generator_1.quoteIdentifier)('name')} TEXT NOT NULL UNIQUE,
+        ${(0, generator_1.quoteIdentifier)('sql')} TEXT NOT NULL,
+        ${(0, generator_1.quoteIdentifier)('created_at')} TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+    `);
+    }
+    async tryRun(fn) {
+        try {
+            const data = await Promise.resolve(fn());
+            return { success: true, data };
+        }
+        catch (err) {
+            const msg = (0, common_1.errorMessage)(err);
+            this.logger.error(msg);
+            return { success: false, error: msg };
+        }
+    }
+    transaction(fn) {
+        if (this.isReadOnly)
+            return Promise.resolve(this.readonlyBlocked());
+        return this.tryRun(() => {
+            this.db.exec('BEGIN');
+            try {
+                const res = fn();
+                this.db.exec('COMMIT');
+                return res;
+            }
+            catch (err) {
+                try {
+                    this.db.exec('ROLLBACK');
+                }
+                catch { }
+                throw err;
+            }
+        });
+    }
+    toBind(value) {
+        if (value === undefined)
+            return null;
+        if (typeof value === 'boolean')
+            return value ? 1 : 0;
+        if (value instanceof Uint8Array || Buffer.isBuffer(value))
+            return value;
+        return value;
+    }
+    async all(sql, params = []) {
+        return this.tryRun(() => this.db.prepare(sql).all(...params));
+    }
+    async run(sql, params = []) {
+        if (this.isReadOnly)
+            return this.readonlyBlocked();
+        return this.tryRun(() => {
+            const info = this.db.prepare(sql).run(...params);
+            return {
+                changes: Number(info.changes),
+                lastInsertRowid: info.lastInsertRowid === undefined || info.lastInsertRowid === null ? null : Number(info.lastInsertRowid),
+            };
+        });
+    }
+    async execResult(sql) {
+        if (this.isReadOnly)
+            return this.readonlyBlocked();
+        return this.tryRun(() => {
+            this.db.exec(sql);
+            return { changes: undefined };
+        });
+    }
+    hasMultipleStatements(sql) {
+        const s = String(sql ?? '').trim();
+        if (!s)
+            return false;
+        try {
+            this.db.prepare(s);
+            return false;
+        }
+        catch (err) {
+            return /more than one statement/i.test((0, common_1.errorMessage)(err));
+        }
+    }
+    async runWrite(sql) {
+        if (this.isReadOnly)
+            return this.readonlyBlocked();
+        const trimmed = String(sql).trim().replace(/;+\s*$/, '');
+        try {
+            const stmt = this.db.prepare(trimmed);
+            const info = stmt.run();
+            return { success: true, data: { changes: Number(info.changes) } };
+        }
+        catch {
+            try {
+                this.db.exec(String(sql));
+                return { success: true, data: { changes: undefined } };
+            }
+            catch (err2) {
+                const msg = (0, common_1.errorMessage)(err2);
+                this.logger.error(msg);
+                return { success: false, error: msg };
+            }
+        }
+    }
+    async listTables() {
+        return this.tryRun(() => (0, introspection_1.listTablesSync)(this.db));
+    }
+    async getTableInfo(table) {
+        return this.tryRun(() => (0, introspection_1.getTableInfoSync)(this.db, table));
+    }
+    async getRowCount(table, filters) {
+        return this.tryRun(() => {
+            const info = this.getTableInfoSync(table);
+            const { where, params } = (0, filters_1.buildFilterClause)(filters, info?.columns.map((c) => c.name) ?? []);
+            const row = this.db
+                .prepare(`SELECT COUNT(*) AS c FROM ${(0, generator_1.quoteIdentifier)(table)}${where}`)
+                .get(...params);
+            return Number(row.c);
+        });
+    }
+    async getRows(table, opts = {}) {
+        return this.tryRun(() => {
+            const info = this.getTableInfoSync(table);
+            const cols = info?.columns ?? [];
+            const orderCol = opts.orderBy || info?.primaryKey?.[0] || cols[0]?.name;
+            const orderDir = opts.orderDir === 'desc' ? 'DESC' : 'ASC';
+            const limit = opts.limit && opts.limit > 0 ? opts.limit : 200;
+            const page = opts.page && opts.page > 0 ? opts.page : 1;
+            const offset = (page - 1) * limit;
+            const { where, params } = (0, filters_1.buildFilterClause)(opts.filters, cols.map((c) => c.name));
+            let sql = `SELECT rowid AS _rowid_, * FROM ${(0, generator_1.quoteIdentifier)(table)}${where}`;
+            if (orderCol)
+                sql += ` ORDER BY ${(0, generator_1.quoteIdentifier)(orderCol)} ${orderDir}`;
+            sql += ` LIMIT ${limit} OFFSET ${offset}`;
+            return this.db.prepare(sql).all(...params);
+        });
+    }
+    async getAllRows(table) {
+        return this.tryRun(() => this.db.prepare(`SELECT rowid AS _rowid_, * FROM ${(0, generator_1.quoteIdentifier)(table)}`).all());
+    }
+    async getRow(table, where) {
+        return this.tryRun(() => {
+            const conds = where.map((w) => `${(0, generator_1.quoteIdentifier)(w.column)} = ?`);
+            const sql = `SELECT rowid AS _rowid_, * FROM ${(0, generator_1.quoteIdentifier)(table)} WHERE ${conds.join(' AND ')} LIMIT 1`;
+            const row = this.db.prepare(sql).get(...where.map((w) => this.toBind(w.value)));
+            return row ? row : null;
+        });
+    }
+    async insertRow(table, fields) {
+        const cols = fields.map((f) => (0, generator_1.quoteIdentifier)(f.column));
+        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)));
+    }
+    async insertRows(table, rows) {
+        return this.transaction(() => {
+            let inserted = 0;
+            for (const fields of rows) {
+                if (!fields.length)
+                    continue;
+                const cols = fields.map((f) => (0, generator_1.quoteIdentifier)(f.column));
+                const sql = `INSERT INTO ${(0, generator_1.quoteIdentifier)(table)} (${cols.join(', ')}) VALUES (${fields.map(() => '?').join(', ')})`;
+                this.db.prepare(sql).run(...fields.map((f) => this.toBind(f.value)));
+                inserted += 1;
+            }
+            return { inserted, skipped: rows.length - inserted };
+        });
+    }
+    async updateRow(table, fields, where) {
+        const sets = fields.map((f) => `${(0, generator_1.quoteIdentifier)(f.column)} = ?`);
+        const conds = where.map((w) => `${(0, generator_1.quoteIdentifier)(w.column)} = ?`);
+        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))]);
+    }
+    async updateRows(table, rows) {
+        return this.transaction(() => {
+            let updated = 0;
+            for (const { fields, where } of rows) {
+                if (!fields.length || !where.length)
+                    continue;
+                const sets = fields.map((f) => `${(0, generator_1.quoteIdentifier)(f.column)} = ?`);
+                const conds = where.map((w) => `${(0, generator_1.quoteIdentifier)(w.column)} = ?`);
+                const sql = `UPDATE ${(0, generator_1.quoteIdentifier)(table)} SET ${sets.join(', ')} WHERE ${conds.join(' AND ')}`;
+                const info = this.db.prepare(sql).run(...[...fields.map((f) => this.toBind(f.value)), ...where.map((w) => this.toBind(w.value))]);
+                updated += Number(info.changes);
+            }
+            return { updated };
+        });
+    }
+    async deleteRow(table, where) {
+        const conds = where.map((w) => `${(0, generator_1.quoteIdentifier)(w.column)} = ?`);
+        const sql = `DELETE FROM ${(0, generator_1.quoteIdentifier)(table)} WHERE ${conds.join(' AND ')}`;
+        return this.run(sql, where.map((w) => this.toBind(w.value)));
+    }
+    async deleteRows(table, rows) {
+        return this.transaction(() => {
+            let deleted = 0;
+            for (const where of rows) {
+                if (!where.length)
+                    continue;
+                const conds = where.map((w) => `${(0, generator_1.quoteIdentifier)(w.column)} = ?`);
+                const sql = `DELETE FROM ${(0, generator_1.quoteIdentifier)(table)} WHERE ${conds.join(' AND ')}`;
+                const info = this.db.prepare(sql).run(...where.map((w) => this.toBind(w.value)));
+                deleted += Number(info.changes);
+            }
+            return { deleted };
+        });
+    }
+    async getRowsByPks(table, pks) {
+        return this.tryRun(() => {
+            const groups = [];
+            const params = [];
+            for (const where of pks) {
+                if (!where.length)
+                    continue;
+                groups.push(where.map((w) => `${(0, generator_1.quoteIdentifier)(w.column)} = ?`).join(' AND '));
+                params.push(...where.map((w) => this.toBind(w.value)));
+            }
+            if (!groups.length)
+                return [];
+            const sql = `SELECT rowid AS _rowid_, * FROM ${(0, generator_1.quoteIdentifier)(table)} WHERE ${groups.map((g) => `(${g})`).join(' OR ')}`;
+            return this.db.prepare(sql).all(...params);
+        });
+    }
+    async getCreateStatement(table) {
+        return this.tryRun(() => {
+            const row = this.db
+                .prepare("SELECT sql FROM sqlite_master WHERE type = 'table' AND name = ?")
+                .get(table);
+            return row?.sql ?? null;
+        });
+    }
+    async listSavedQueries() {
+        return this.all(`SELECT id, name, sql, created_at FROM ${(0, generator_1.quoteIdentifier)(types_1.INTERNAL_TABLES.savedQueries)} ORDER BY name COLLATE NOCASE`);
+    }
+    async saveQuery(name, sql) {
+        return this.run(`INSERT INTO ${(0, generator_1.quoteIdentifier)(types_1.INTERNAL_TABLES.savedQueries)} (name, sql) VALUES (?, ?)`, [name, sql]);
+    }
+    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));
+    }
+    async getReferencingTables(table) {
+        return this.tryRun(() => (0, introspection_1.getReferencingTablesSync)(this.db, table));
+    }
+    async getRowsByFk(table, column, value, limit = 50) {
+        return this.tryRun(() => {
+            const n = Math.max(1, Math.min(500, Number(limit) || 50));
+            const countRow = this.db
+                .prepare(`SELECT COUNT(*) AS c FROM ${(0, generator_1.quoteIdentifier)(table)} WHERE ${(0, generator_1.quoteIdentifier)(column)} = ?`)
+                .get(value);
+            const rows = this.db
+                .prepare(`SELECT * FROM ${(0, generator_1.quoteIdentifier)(table)} WHERE ${(0, generator_1.quoteIdentifier)(column)} = ? LIMIT ${n}`)
+                .all(value);
+            return { rows, total: Number(countRow.c) };
+        });
+    }
+    async renameTable(oldName, newName) {
+        return this.execResult((0, generator_1.generateRenameTable)(oldName, newName));
+    }
+    async addColumn(table, col) {
+        if (this.isReadOnly)
+            return this.readonlyBlocked();
+        return this.tryRun(() => {
+            if (col.primaryKey) {
+                return (0, migrations_1.modifyTableStructureSync)(this.db, table, (existingCols) => [...existingCols, col]);
+            }
+            try {
+                const colCopy = { ...col, unique: false };
+                const sql = (0, generator_1.generateAddColumn)(table, colCopy);
+                this.db.exec(sql);
+                if (col.unique) {
+                    const idxName = `idx_${table}_${col.name}_unique`;
+                    this.db.exec(`CREATE UNIQUE INDEX IF NOT EXISTS ${(0, generator_1.quoteIdentifier)(idxName)} ON ${(0, generator_1.quoteIdentifier)(table)} (${(0, generator_1.quoteIdentifier)(col.name)});`);
+                }
+                return { changes: 1 };
+            }
+            catch {
+                return (0, migrations_1.modifyTableStructureSync)(this.db, table, (existingCols) => [...existingCols, col]);
+            }
+        });
+    }
+    async modifyColumn(table, oldColName, newColDef) {
+        if (this.isReadOnly)
+            return this.readonlyBlocked();
+        return this.tryRun(() => {
+            const newName = String(newColDef.name || oldColName).trim();
+            const rawCols = this.db.prepare(`PRAGMA table_info(${(0, generator_1.quoteIdentifier)(table)})`).all();
+            const existing = rawCols.find((c) => c.name === oldColName);
+            if (!existing)
+                throw new Error(`Column "${oldColName}" does not exist in table "${table}".`);
+            const fks = this.db.prepare(`PRAGMA foreign_key_list(${(0, generator_1.quoteIdentifier)(table)})`).all();
+            const existingFk = fks.find((f) => f.from === oldColName);
+            const indexRows = this.db.prepare(`PRAGMA index_list(${(0, generator_1.quoteIdentifier)(table)})`).all();
+            let existingIsUnique = false;
+            for (const ix of indexRows) {
+                if (ix.unique) {
+                    const ixCols = this.db.prepare(`PRAGMA index_info(${(0, generator_1.quoteIdentifier)(ix.name)})`).all().map((c) => c.name);
+                    if (ixCols.length === 1 && ixCols[0] === oldColName) {
+                        existingIsUnique = true;
+                        break;
+                    }
+                }
+            }
+            const typeMatches = !newColDef.type || newColDef.type.toUpperCase() === existing.type.toUpperCase();
+            const pkMatches = newColDef.primaryKey === undefined || newColDef.primaryKey === (existing.pk > 0);
+            const notNullMatches = newColDef.notNull === undefined || newColDef.notNull === (!!existing.notnull);
+            const uniqueMatches = newColDef.unique === undefined || newColDef.unique === existingIsUnique;
+            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));
+            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));
+                for (const suffix of ['', '_unique']) {
+                    const defaultOldIdx = `idx_${table}_${oldColName}${suffix}`;
+                    if (existingIdxNames.has(defaultOldIdx)) {
+                        const newIdxName = `idx_${table}_${newName}${suffix}`;
+                        const uniqueKeyword = suffix === '_unique' ? 'UNIQUE ' : '';
+                        try {
+                            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 { }
+                    }
+                }
+                return { changes: 1 };
+            }
+            if (oldColName === newName && typeMatches && pkMatches && notNullMatches && uniqueMatches && defaultMatches && fkMatches) {
+                return { changes: 0 };
+            }
+            return (0, migrations_1.modifyTableStructureSync)(this.db, table, (cols) => {
+                const idx = cols.findIndex((c) => c.name === oldColName);
+                if (idx === -1)
+                    throw new Error(`Column "${oldColName}" does not exist in table "${table}".`);
+                const updated = [...cols];
+                updated[idx] = {
+                    ...updated[idx],
+                    name: newName,
+                    type: newColDef.type || updated[idx].type,
+                    primaryKey: newColDef.primaryKey !== undefined ? newColDef.primaryKey : updated[idx].primaryKey,
+                    notNull: newColDef.notNull !== undefined ? newColDef.notNull : updated[idx].notNull,
+                    unique: newColDef.unique !== undefined ? newColDef.unique : updated[idx].unique,
+                    defaultValue: newColDef.defaultValue !== undefined ? newColDef.defaultValue : updated[idx].defaultValue,
+                    foreignKey: newColDef.foreignKey !== undefined ? newColDef.foreignKey : updated[idx].foreignKey,
+                };
+                return updated;
+            }, oldColName, newName);
+        });
+    }
+    async renameColumn(table, oldName, newName) {
+        if (this.isReadOnly)
+            return this.readonlyBlocked();
+        return this.tryRun(() => {
+            this.db.exec((0, generator_1.generateRenameColumn)(table, oldName, newName));
+            const indexRows = this.db.prepare(`PRAGMA index_list(${(0, generator_1.quoteIdentifier)(table)})`).all();
+            const existingIdxNames = new Set(indexRows.map((i) => i.name));
+            for (const suffix of ['', '_unique']) {
+                const defaultOldIdx = `idx_${table}_${oldName}${suffix}`;
+                if (existingIdxNames.has(defaultOldIdx)) {
+                    const newIdxName = `idx_${table}_${newName}${suffix}`;
+                    const uniqueKeyword = suffix === '_unique' ? 'UNIQUE ' : '';
+                    try {
+                        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 { }
+                }
+            }
+            return { changes: 1 };
+        });
+    }
+    async dropColumn(table, column) {
+        return this.execResult((0, generator_1.generateDropColumn)(table, column));
+    }
+    async dropTable(table) {
+        return this.execResult((0, generator_1.generateDropTable)(table));
+    }
+    async createIndex(table, index) {
+        return this.execResult((0, generator_1.generateCreateIndex)(table, index));
+    }
+    async dropIndex(indexName) {
+        return this.execResult((0, generator_1.generateDropIndex)(indexName));
+    }
+    getTableInfoSync(table) {
+        try {
+            const cols = this.db.prepare(`PRAGMA table_info(${(0, generator_1.quoteIdentifier)(table)})`).all();
+            if (!cols.length)
+                return null;
+            const primaryKey = cols.filter((c) => c.pk > 0).sort((a, b) => a.pk - b.pk).map((c) => c.name);
+            return { table, columns: cols, foreignKeys: [], primaryKey, indexes: [], sql: null };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+exports.SqliteDatabase = SqliteDatabase;

package/dist/db/export.d.ts

@@ -1 +1 @@
-import type {IDatabase} from './types';export interface DumpResult{success:boolean;data?:string;error?:string;}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 +1,90 @@
-Object.defineProperty(exports,"__esModule",{value:!0}),exports.generateSqlDump=async function(db){const out=[];"sqlite"===db.dialect?(out.push("PRAGMA foreign_keys=OFF;"),out.push("BEGIN TRANSACTION;")):out.push("BEGIN;");const tables=await db.listTables();if(!tables.success)return{success:!1,error:tables.error??"Failed to list tables."};for(const t of tables.data??[]){const name=t.name,create=await db.getCreateStatement(name);create.success&&create.data&&out.push(create.data.trim());const info=await db.getTableInfo(name),rows=await db.getAllRows(name);if(info.success&&rows.success){const cols=info.data?.columns??[];for(const row of rows.data??[]){const fields=cols.map(c=>({column:c.name,value:row[c.name]}));out.push((0,generator_1.generateInsert)(name,fields))}}out.push("")}return out.push("COMMIT;"),{success:!0,data:out.join("\n")}};const generator_1=require("../sql/generator");
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSqlDump = generateSqlDump;
+exports.generateSchemaDump = generateSchemaDump;
+const generator_1 = require("../sql/generator");
+async function generateSqlDump(db) {
+    const out = [];
+    if (db.dialect === 'sqlite') {
+        out.push('PRAGMA foreign_keys=OFF;');
+        out.push('BEGIN TRANSACTION;');
+    }
+    else {
+        out.push('BEGIN;');
+    }
+    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 create = await db.getCreateStatement(name);
+        if (create.success && create.data) {
+            out.push(create.data.trim());
+        }
+        const info = await db.getTableInfo(name);
+        const rows = await db.getAllRows(name);
+        if (info.success && rows.success) {
+            const cols = info.data?.columns ?? [];
+            for (const row of rows.data ?? []) {
+                const fields = cols.map((c) => ({ column: c.name, value: row[c.name] }));
+                out.push((0, generator_1.generateInsert)(name, fields));
+            }
+        }
+        out.push('');
+    }
+    out.push('COMMIT;');
+    return { success: true, data: out.join('\n') };
+}
+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() };
+}