admindb 2.4.1 → 2.5.0

package/dist/db/introspection.js

@@ -1,164 +0,0 @@
-"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 }));
-}
-function getTableNames(db) {
-    return db
-        .prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%'")
-        .all().map((r) => r.name);
-}
-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 { }
-    }
-    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: Boolean(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, indexes } = info;
-    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 { }
-        result.push({ table: t, refs: tRefs, refCount });
-    }
-    result.sort((a, b) => a.table.localeCompare(b.table));
-    return result;
-}

package/dist/routes/api/erd.d.ts

@@ -1 +0,0 @@
-import{type ApiContext} from './helpers';import type {Router} from 'express';export declare function registerErdRoutes(router:Router,ctx:ApiContext):void;

package/dist/routes/api/erd.js

@@ -1,45 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerErdRoutes = registerErdRoutes;
-const helpers_1 = require("./helpers");
-function registerErdRoutes(router, ctx) {
-    router.get('/api/erd/:db', async (req, res) => {
-        try {
-            const db = ctx.getDb(req);
-            const tablesResult = await db.listTables();
-            if (!tablesResult.success || !tablesResult.data) {
-                return (0, helpers_1.fail)(res, tablesResult.error ?? 'Failed to list tables.', 500);
-            }
-            const tableNames = tablesResult.data.map((t) => t.name);
-            const tables = await Promise.all(tableNames.map(async (name) => {
-                const infoResult = await db.getTableInfo(name);
-                if (!infoResult.success || !infoResult.data) {
-                    return { name, columns: [], foreignKeys: [], primaryKey: [] };
-                }
-                const { columns, foreignKeys, primaryKey } = infoResult.data;
-                return {
-                    name,
-                    columns: columns.map((c) => ({
-                        name: c.name,
-                        type: c.type,
-                        pk: c.pk,
-                        notnull: c.notnull,
-                        dflt_value: c.dflt_value,
-                    })),
-                    foreignKeys: foreignKeys.map((fk) => ({
-                        from: fk.from,
-                        table: fk.table,
-                        to: fk.to ?? '',
-                        on_delete: fk.on_delete,
-                        on_update: fk.on_update,
-                    })),
-                    primaryKey,
-                };
-            }));
-            (0, helpers_1.ok)(res, { tables });
-        }
-        catch (err) {
-            (0, helpers_1.fail)(res, err.message ?? 'Unknown error.', 500);
-        }
-    });
-}

package/dist/routes/api/helpers.d.ts

@@ -1 +0,0 @@
-import type {Request,Response} from 'express';import type {IDatabase,TableInfoData,WhereClause} from '../../db/index';import type {Logger} from '../../utils/logger';import{type ColumnPlan,type ErChainScope,type GenerationPlan,type TableGenerationMode} from '../../data/index';export interface ApiContext{getDb:(req:Request)=>IDatabase;logger:Logger;}export declare const ok:(res:Response,data:unknown,status?:number)=>Response;export declare const fail:(res:Response,error:string,status?:number,details?:Record<string,unknown>|null)=>Response;export declare const wrap:(fn:(req:Request,res:Response)=>unknown)=>(req:Request,res:Response)=>Promise<void>;export declare function requireTable(db:IDatabase,table:string):Promise<TableInfoData|null>;export declare function buildFields(info:TableInfoData,values:Record<string,unknown>,opts?:{excludePk?:boolean;}):{column:string;value:unknown;}[];export declare function buildUpdateFields(info:TableInfoData,values:Record<string,unknown>,nulls:string[]):{column:string;value:unknown;}[];export declare function pkWhere(info:TableInfoData,encodedId:string):{column:string;value:unknown;}[]|null;export declare const MAX_BULK_ROWS=1000;export declare function parseSeedRequest(body:unknown):{count:number;plan:Record<string,ColumnPlan>;truncate:boolean;seed?:number|null;};export declare function parseChainSeedRequest(body:unknown):{scope:ErChainScope;counts:Record<string,number>;plans:Record<string,Record<string,ColumnPlan>>;truncate:boolean;modes?:Record<string,TableGenerationMode>;seed?:number|null;};export declare function parseUnifiedGenerationPlan(body:unknown):GenerationPlan;export declare function resolvePkRows(info:TableInfoData,ids:unknown):WhereClause[][]|null;export declare function computeBulkImpact(db:IDatabase,info:TableInfoData,wheres:WhereClause[][]):Promise<{references:{table:string; from :string;to:string;count:number;}[];total:number;}>;

package/dist/routes/api/import-export.d.ts

@@ -1 +0,0 @@
-import type {Router} from 'express';import{type ApiContext} from './helpers';export declare function registerImportExportRoutes(router:Router,ctx:ApiContext):void;

package/dist/routes/api/import-export.js

@@ -1,84 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerImportExportRoutes = registerImportExportRoutes;
-const common_1 = require("../../utils/common");
-const csv_1 = require("../../utils/csv");
-const helpers_1 = require("./helpers");
-function registerImportExportRoutes(router, ctx) {
-    router.get('/api/tables/:db/:table/export', (0, helpers_1.wrap)(async (req, res) => {
-        const db = ctx.getDb(req);
-        const info = await (0, helpers_1.requireTable)(db, req.params.table);
-        if (!info)
-            return (0, helpers_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
-        const format = String(req.query.format ?? 'csv').toLowerCase();
-        const filters = (0, common_1.parseFilters)(req.query.f);
-        const r = await db.getRows(req.params.table, { limit: 1_000_000, filters });
-        if (!r.success)
-            return (0, helpers_1.fail)(res, r.error ?? 'Failed to export table.');
-        const rows = (r.data ?? []).map(common_1.normalizeRow);
-        const columns = info.columns.map((c) => c.name);
-        if (format === 'json') {
-            res.setHeader('Content-Type', 'application/json; charset=utf-8');
-            res.setHeader('Content-Disposition', `attachment; filename="${req.params.table}.json"`);
-            return res.send((0, csv_1.toJson)(rows));
-        }
-        res.setHeader('Content-Type', 'text/csv; charset=utf-8');
-        res.setHeader('Content-Disposition', `attachment; filename="${req.params.table}.csv"`);
-        res.send((0, csv_1.toCsv)(rows, columns));
-    }));
-    const importCsvHandler = (0, helpers_1.wrap)(async (req, res) => {
-        const db = ctx.getDb(req);
-        const info = await (0, helpers_1.requireTable)(db, req.params.table);
-        if (!info)
-            return (0, helpers_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
-        const csvText = typeof req.body === 'string' ? req.body : String(req.body?.csv ?? '');
-        if (!csvText.trim())
-            return (0, helpers_1.fail)(res, 'No CSV data provided.');
-        const parsed = (0, csv_1.parseCsv)(csvText);
-        if (!parsed.length)
-            return (0, helpers_1.fail)(res, 'CSV file is empty.');
-        const header = parsed[0].map((h) => h.trim());
-        const typeMap = new Map(info.columns.map((c) => [c.name, c.type]));
-        const validCols = header.filter((h) => typeMap.has(h));
-        if (!validCols.length) {
-            return (0, helpers_1.fail)(res, 'None of the CSV columns match columns in this table.');
-        }
-        const rows = parsed.slice(1).map((line) => {
-            const fields = [];
-            for (let i = 0; i < header.length; i++) {
-                const col = header[i];
-                if (!typeMap.has(col))
-                    continue;
-                fields.push({ column: col, value: (0, common_1.coerceFormValue)(line[i] ?? '', typeMap.get(col)) });
-            }
-            return fields;
-        });
-        const r = await db.insertRows(req.params.table, rows);
-        if (!r.success)
-            return (0, helpers_1.fail)(res, r.error ?? 'Failed to import CSV.');
-        (0, helpers_1.ok)(res, { message: `${r.data?.inserted ?? 0} row(s) imported.`, inserted: r.data?.inserted });
-    });
-    router.post('/api/tables/:db/:table/import', importCsvHandler);
-    router.post('/api/tables/:db/:table/rows/import', importCsvHandler);
-    router.post('/api/tables/:db/:table/import/csv', importCsvHandler);
-    router.post('/api/query/:db/export', (0, helpers_1.wrap)(async (req, res) => {
-        const db = ctx.getDb(req);
-        const sql = String(req.body?.sql ?? '').trim();
-        const format = String(req.body?.format ?? 'csv').toLowerCase();
-        if (!sql)
-            return (0, helpers_1.fail)(res, 'SQL query is required.');
-        const r = await db.all(sql);
-        if (!r.success)
-            return (0, helpers_1.fail)(res, r.error ?? 'Query failed.', 400);
-        const rows = (r.data ?? []).map(common_1.normalizeRow);
-        const columns = rows.length ? Object.keys(rows[0]) : [];
-        if (format === 'json') {
-            res.setHeader('Content-Type', 'application/json; charset=utf-8');
-            res.setHeader('Content-Disposition', 'attachment; filename="query_results.json"');
-            return res.send((0, csv_1.toJson)(rows));
-        }
-        res.setHeader('Content-Type', 'text/csv; charset=utf-8');
-        res.setHeader('Content-Disposition', 'attachment; filename="query_results.csv"');
-        res.send((0, csv_1.toCsv)(rows, columns));
-    }));
-}

package/dist/routes/api/index.d.ts

@@ -1 +0,0 @@
-import type {Router} from 'express';import{type ApiContext} from './helpers';export{type ApiContext} from './helpers';export declare function registerApi(router:Router,ctx:ApiContext):void;

package/dist/routes/api/index.js

@@ -1,55 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerApi = registerApi;
-const tables_1 = require("./tables");
-const rows_1 = require("./rows");
-const import_export_1 = require("./import-export");
-const seed_1 = require("./seed");
-const query_1 = require("./query");
-const erd_1 = require("./erd");
-const export_1 = require("../../db/export");
-function registerApi(router, ctx) {
-    router.use((req, res, next) => {
-        if (req.method === 'GET')
-            return next();
-        const p = req.path;
-        if (p.endsWith('/generate') ||
-            p.endsWith('/preview') ||
-            p.includes('/api/query/') ||
-            p.endsWith('/rows/bulk-impact') ||
-            p.endsWith('/rows/bulk-export')) {
-            return next();
-        }
-        try {
-            const db = ctx.getDb(req);
-            if (db && db.isReadOnly) {
-                return res.status(403).json({
-                    success: false,
-                    error: 'Database is open in read-only mode — write operations are disabled.',
-                });
-            }
-        }
-        catch {
-        }
-        return next();
-    });
-    (0, tables_1.registerTableRoutes)(router, ctx);
-    (0, rows_1.registerRowRoutes)(router, ctx);
-    (0, import_export_1.registerImportExportRoutes)(router, ctx);
-    (0, seed_1.registerSeedRoutes)(router, ctx);
-    (0, query_1.registerQueryRoutes)(router, ctx);
-    (0, erd_1.registerErdRoutes)(router, ctx);
-    router.get('/api/info/:db/ddl', async (req, res) => {
-        try {
-            const db = ctx.getDb(req);
-            const dump = await (0, export_1.generateSchemaDump)(db);
-            if (!dump.success) {
-                return res.status(500).json({ success: false, error: dump.error });
-            }
-            res.json({ success: true, data: dump.data });
-        }
-        catch (err) {
-            res.status(500).json({ success: false, error: err instanceof Error ? err.message : String(err) });
-        }
-    });
-}

package/dist/routes/api/query.d.ts

@@ -1 +0,0 @@
-import type {Router} from 'express';import{type ApiContext} from './helpers';export declare function registerQueryRoutes(router:Router,ctx:ApiContext):void;

package/dist/routes/api/query.js

@@ -1,77 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerQueryRoutes = registerQueryRoutes;
-const classifier_1 = require("../../sql/classifier");
-const error_analyzer_1 = require("../../sql/error-analyzer");
-const common_1 = require("../../utils/common");
-const helpers_1 = require("./helpers");
-function registerQueryRoutes(router, ctx) {
-    router.post('/api/query/:db', (0, helpers_1.wrap)(async (req, res) => {
-        const db = ctx.getDb(req);
-        const rawSql = String(req.body?.sql ?? '').trim();
-        if (!rawSql)
-            return (0, helpers_1.fail)(res, 'SQL query is required.');
-        const { kind } = (0, classifier_1.classifySql)(rawSql);
-        if (db.hasMultipleStatements(rawSql)) {
-            if (db.isReadOnly) {
-                return (0, helpers_1.fail)(res, 'Database is open in read-only mode — write statements are disabled.', 403);
-            }
-            const r = await db.execResult(rawSql);
-            if (!r.success) {
-                const details = await (0, error_analyzer_1.analyzeSqlError)(rawSql, r.error ?? 'Script execution failed.', db);
-                return (0, helpers_1.fail)(res, r.error ?? 'Query failed.', 400, details);
-            }
-            return (0, helpers_1.ok)(res, { kind: 'script', message: 'Script executed successfully.' });
-        }
-        if (kind === 'select' || kind === 'read' || kind === 'count') {
-            const r = await db.all(rawSql);
-            if (!r.success) {
-                const details = await (0, error_analyzer_1.analyzeSqlError)(rawSql, r.error ?? 'Query execution failed.', db);
-                return (0, helpers_1.fail)(res, r.error ?? 'Query failed.', 400, details);
-            }
-            const rows = (r.data ?? []).map(common_1.normalizeRow);
-            return (0, helpers_1.ok)(res, { kind: 'select', columns: rows.length ? Object.keys(rows[0]) : [], rows });
-        }
-        if (db.isReadOnly) {
-            return (0, helpers_1.fail)(res, 'Database is open in read-only mode — write statements are disabled.', 403);
-        }
-        const r = await db.runWrite(rawSql);
-        if (!r.success) {
-            const details = await (0, error_analyzer_1.analyzeSqlError)(rawSql, r.error ?? 'Statement execution failed.', db);
-            return (0, helpers_1.fail)(res, r.error ?? 'Query failed.', 400, details);
-        }
-        const changes = r.data?.changes;
-        (0, helpers_1.ok)(res, {
-            kind: 'write',
-            changes: changes ?? null,
-            message: changes != null ? `${changes} row(s) affected.` : 'Statement executed successfully.',
-        });
-    }));
-    router.get('/api/queries/:db', (0, helpers_1.wrap)(async (req, res) => {
-        const db = ctx.getDb(req);
-        const r = await db.listSavedQueries();
-        if (!r.success)
-            return (0, helpers_1.fail)(res, r.error ?? 'Failed to load queries.', 500);
-        (0, helpers_1.ok)(res, r.data);
-    }));
-    router.post('/api/queries/:db', (0, helpers_1.wrap)(async (req, res) => {
-        const db = ctx.getDb(req);
-        const name = String(req.body?.name ?? '').trim();
-        const sql = String(req.body?.sql ?? '').trim();
-        if (!name)
-            return (0, helpers_1.fail)(res, 'Query name is required.');
-        if (!sql)
-            return (0, helpers_1.fail)(res, 'Query SQL is required.');
-        const r = await db.saveQuery(name, sql);
-        if (!r.success)
-            return (0, helpers_1.fail)(res, r.error ?? 'Failed to save query.', 400);
-        (0, helpers_1.ok)(res, { message: 'Query saved.' }, 201);
-    }));
-    router.delete('/api/queries/:db/:id', (0, helpers_1.wrap)(async (req, res) => {
-        const db = ctx.getDb(req);
-        const r = await db.deleteSavedQuery(req.params.id);
-        if (!r.success)
-            return (0, helpers_1.fail)(res, r.error ?? 'Failed to delete query.', 400);
-        (0, helpers_1.ok)(res, { message: 'Query deleted.' });
-    }));
-}

package/dist/routes/api/rows.d.ts

@@ -1 +0,0 @@
-import type {Router} from 'express';import{type ApiContext} from './helpers';export declare function registerRowRoutes(router:Router,ctx:ApiContext):void;