admindb 2.1.1 → 2.3.0

package/dist/data/validator.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateGenerationPlan = validateGenerationPlan;
+const templates_1 = require("./templates");
+async function validateGenerationPlan(db, plan, tableInfos) {
+    const issues = [];
+    const infos = tableInfos ?? new Map();
+    for (const tableName of Object.keys(plan.tables)) {
+        if (!infos.has(tableName)) {
+            try {
+                const res = await db.getTableInfo(tableName);
+                if (res.success && res.data?.columns?.length) {
+                    infos.set(tableName, res.data);
+                }
+                else {
+                    issues.push({
+                        type: 'error',
+                        table: tableName,
+                        message: `Table "${tableName}" does not exist in the database.`,
+                        code: 'TABLE_NOT_FOUND',
+                    });
+                }
+            }
+            catch (err) {
+                issues.push({
+                    type: 'error',
+                    table: tableName,
+                    message: `Failed to inspect table "${tableName}": ${err instanceof Error ? err.message : String(err)}`,
+                    code: 'TABLE_INSPECT_ERROR',
+                });
+            }
+        }
+    }
+    let estimatedTotalRows = 0;
+    let tablesToGenerate = 0;
+    let tablesToUseExisting = 0;
+    let tablesToSkip = 0;
+    for (const [tableName, spec] of Object.entries(plan.tables)) {
+        const info = infos.get(tableName);
+        if (!info)
+            continue;
+        const mode = spec.mode || 'generate';
+        const rowCount = Math.max(0, spec.rows ?? 10);
+        if (mode === 'generate') {
+            tablesToGenerate++;
+            estimatedTotalRows += rowCount;
+        }
+        else if (mode === 'use_existing') {
+            tablesToUseExisting++;
+        }
+        else if (mode === 'generate_if_empty') {
+            try {
+                const cRes = await db.getRowCount(tableName);
+                const curCount = cRes.success && typeof cRes.data === 'number' ? cRes.data : 0;
+                if (curCount === 0) {
+                    tablesToGenerate++;
+                    estimatedTotalRows += rowCount;
+                }
+                else {
+                    tablesToUseExisting++;
+                }
+            }
+            catch {
+                tablesToGenerate++;
+                estimatedTotalRows += rowCount;
+            }
+        }
+        else {
+            tablesToSkip++;
+        }
+        if (mode === 'skip' || mode === 'use_existing')
+            continue;
+        const colMap = new Map(info.columns.map((c) => [c.name, c]));
+        const fkMap = new Map(info.foreignKeys.map((fk) => [fk.from, fk]));
+        const colNames = info.columns.map((c) => c.name);
+        const { hasCycle, cycleColumns } = (0, templates_1.orderColumnDependencies)(colNames, spec.columns || {});
+        if (hasCycle) {
+            issues.push({
+                type: 'error',
+                table: tableName,
+                message: `Circular column template dependency detected in table "${tableName}" between columns: ${cycleColumns.join(', ')}`,
+                code: 'TEMPLATE_CYCLE',
+            });
+        }
+        for (const col of info.columns) {
+            const p = spec.columns[col.name] || { strategy: 'skip' };
+            if (p.strategy === 'template' && p.template) {
+                for (const dep of (0, templates_1.extractTemplateDependencies)(p.template)) {
+                    if (!colMap.has(dep)) {
+                        issues.push({
+                            type: 'warning',
+                            table: tableName,
+                            column: col.name,
+                            message: `Template in column "${col.name}" references non-existent column "${dep}".`,
+                            code: 'TEMPLATE_INVALID_REF',
+                        });
+                    }
+                }
+            }
+            const isReq = Boolean(col.notnull || (col.pk ?? 0) > 0);
+            if (isReq && col.dflt_value == null) {
+                if (p.strategy === 'null') {
+                    issues.push({
+                        type: 'error',
+                        table: tableName,
+                        column: col.name,
+                        message: `Column "${col.name}" is NOT NULL without a default value, but strategy is set to NULL.`,
+                        code: 'NOT_NULL_VIOLATION',
+                    });
+                }
+                if (p.strategy === 'skip' && !col.pk) {
+                    issues.push({
+                        type: 'warning',
+                        table: tableName,
+                        column: col.name,
+                        message: `Column "${col.name}" is NOT NULL without a default value, but strategy is set to Skip (database default).`,
+                        code: 'NOT_NULL_SKIP',
+                    });
+                }
+            }
+            const fk = fkMap.get(col.name);
+            if (p.strategy === 'fk' && fk) {
+                const parentSpec = plan.tables[fk.table];
+                if (parentSpec?.mode === 'skip') {
+                    try {
+                        const countRes = await db.getRowCount(fk.table);
+                        const parentRows = countRes.success && typeof countRes.data === 'number' ? countRes.data : 0;
+                        if (parentRows === 0 && (col.notnull || (col.pk ?? 0) > 0)) {
+                            issues.push({
+                                type: 'error',
+                                table: tableName,
+                                column: col.name,
+                                message: `Foreign key "${col.name}" references table "${fk.table}" which is set to "Don't Touch" and is currently empty.`,
+                                code: 'FK_EMPTY_PARENT',
+                            });
+                        }
+                    }
+                    catch { }
+                }
+            }
+        }
+    }
+    const errors = issues.filter((i) => i.type === 'error');
+    const valid = errors.length === 0;
+    return {
+        valid,
+        canExecute: valid,
+        issues,
+        summary: {
+            totalTables: Object.keys(plan.tables).length,
+            tablesToGenerate,
+            tablesToUseExisting,
+            tablesToSkip,
+            estimatedTotalRows,
+            cyclesDetected: false,
+            cycleTables: [],
+            executionOrder: Object.keys(plan.tables),
+        },
+    };
+}

package/dist/db/database.d.ts

@@ -1 +1 @@
-import type {Logger} from '../utils/logger';import{type ColumnDef,type IndexDef} from '../sql/generator';import type {DatabaseDialect,DbOpenOptions,IDatabase,ReferencingTableInfo,Result,RowFilters,SavedQuery,SchemaInfo,SQLInputValue,TableInfoData,TableListItem,WhereClause} from './types';export * from './types';export * from './filters';export declare class SqliteDatabase implements IDatabase{private db;private logger;readonly path:string;readonly isReadOnly:boolean;readonly dialect:DatabaseDialect;constructor(dbPath:string,logger:Logger,options?:DbOpenOptions);private readonlyBlocked;close():void;private initSchema;private tryRun;private transaction;private toBind;all(sql:string,params?:SQLInputValue[]):Promise<Result<unknown[]>>;run(sql:string,params?:SQLInputValue[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;execResult(sql:string):Promise<Result<{changes?:number;}>>;hasMultipleStatements(sql:string):boolean;runWrite(sql:string):Promise<Result<{changes?:number;}>>;listTables():Promise<Result<TableListItem[]>>;getTableInfo(table:string):Promise<Result<TableInfoData>>;getRowCount(table:string,filters?:RowFilters):Promise<Result<number>>;getRows(table:string,opts?:{page?:number;limit?:number;orderBy?:string;orderDir?:'asc'|'desc';filters?:RowFilters;}):Promise<Result<Record<string,unknown>[]>>;getAllRows(table:string):Promise<Result<Record<string,unknown>[]>>;getRow(table:string,where:WhereClause[]):Promise<Result<Record<string,unknown>|null>>;insertRow(table:string,fields:WhereClause[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;insertRows(table:string,rows:WhereClause[][]):Promise<Result<{inserted:number;skipped:number;}>>;updateRow(table:string,fields:WhereClause[],where:WhereClause[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;updateRows(table:string,rows:{fields:WhereClause[];where:WhereClause[];}[]):Promise<Result<{updated:number;}>>;deleteRow(table:string,where:WhereClause[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;deleteRows(table:string,rows:WhereClause[][]):Promise<Result<{deleted:number;}>>;getRowsByPks(table:string,pks:WhereClause[][]):Promise<Result<Record<string,unknown>[]>>;getCreateStatement(table:string):Promise<Result<string|null>>;listSavedQueries():Promise<Result<SavedQuery[]>>;saveQuery(name:string,sql:string):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;deleteSavedQuery(id:string|number):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;getSchema(table:string):Promise<Result<SchemaInfo>>;getReferencingTables(table:string):Promise<Result<ReferencingTableInfo[]>>;getRowsByFk(table:string,column:string,value:unknown,limit?:number):Promise<Result<{rows:Record<string,unknown>[];total:number;}>>;renameTable(oldName:string,newName:string):Promise<Result<{changes?:number;}>>;addColumn(table:string,col:ColumnDef):Promise<Result<{changes?:number;}>>;modifyColumn(table:string,oldColName:string,newColDef:ColumnDef):Promise<Result<{changes?:number;}>>;renameColumn(table:string,oldName:string,newName:string):Promise<Result<{changes?:number;}>>;dropColumn(table:string,column:string):Promise<Result<{changes?:number;}>>;dropTable(table:string):Promise<Result<{changes?:number;}>>;createIndex(table:string,index:IndexDef):Promise<Result<{changes?:number;}>>;dropIndex(indexName:string):Promise<Result<{changes?:number;}>>;private getTableInfoSync;}
+import type {Logger} from '../utils/logger';import{type ColumnDef,type IndexDef} from '../sql/generator';import type {DatabaseDialect,DbOpenOptions,IDatabase,ReferencingTableInfo,Result,RowFilters,SavedQuery,SchemaInfo,SQLInputValue,TableInfoData,TableListItem,WhereClause} from './types';export * from './types';export * from './filters';export declare class SqliteDatabase implements IDatabase{private db;private logger;readonly path:string;readonly isReadOnly:boolean;readonly dialect:DatabaseDialect;constructor(dbPath:string,logger:Logger,options?:DbOpenOptions);private readonlyBlocked;close():void;private initSchema;private tryRun;private transaction;private toBind;all(sql:string,params?:SQLInputValue[]):Promise<Result<unknown[]>>;run(sql:string,params?:SQLInputValue[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;execResult(sql:string):Promise<Result<{changes?:number;}>>;hasMultipleStatements(sql:string):boolean;runWrite(sql:string):Promise<Result<{changes?:number;}>>;listTables():Promise<Result<TableListItem[]>>;getTableInfo(table:string):Promise<Result<TableInfoData>>;getRowCount(table:string,filters?:RowFilters):Promise<Result<number>>;getRows(table:string,opts?:{page?:number;limit?:number;orderBy?:string;orderDir?:'asc'|'desc';filters?:RowFilters;}):Promise<Result<Record<string,unknown>[]>>;getAllRows(table:string):Promise<Result<Record<string,unknown>[]>>;getRow(table:string,where:WhereClause[]):Promise<Result<Record<string,unknown>|null>>;insertRow(table:string,fields:WhereClause[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;insertRows(table:string,rows:WhereClause[][]):Promise<Result<{inserted:number;skipped:number;}>>;updateRow(table:string,fields:WhereClause[],where:WhereClause[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;updateRows(table:string,rows:{fields:WhereClause[];where:WhereClause[];}[]):Promise<Result<{updated:number;}>>;deleteRow(table:string,where:WhereClause[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;deleteRows(table:string,rows:WhereClause[][]):Promise<Result<{deleted:number;}>>;getRowsByPks(table:string,pks:WhereClause[][]):Promise<Result<Record<string,unknown>[]>>;getCreateStatement(table:string):Promise<Result<string|null>>;listSavedQueries():Promise<Result<SavedQuery[]>>;saveQuery(name:string,sql:string):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;deleteSavedQuery(id:string|number):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;getSettings():Promise<Result<Record<string,string>>>;getSchema(table:string):Promise<Result<SchemaInfo>>;getReferencingTables(table:string):Promise<Result<ReferencingTableInfo[]>>;getRowsByFk(table:string,column:string,value:unknown,limit?:number):Promise<Result<{rows:Record<string,unknown>[];total:number;}>>;renameTable(oldName:string,newName:string):Promise<Result<{changes?:number;}>>;addColumn(table:string,col:ColumnDef):Promise<Result<{changes?:number;}>>;modifyColumn(table:string,oldColName:string,newColDef:ColumnDef):Promise<Result<{changes?:number;}>>;renameColumn(table:string,oldName:string,newName:string):Promise<Result<{changes?:number;}>>;dropColumn(table:string,column:string):Promise<Result<{changes?:number;}>>;dropTable(table:string):Promise<Result<{changes?:number;}>>;createIndex(table:string,index:IndexDef):Promise<Result<{changes?:number;}>>;dropIndex(indexName:string):Promise<Result<{changes?:number;}>>;private getTableInfoSync;}