admindb 2.1.0 → 2.2.1

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

@@ -0,0 +1 @@
+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

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerErdRoutes = registerErdRoutes;
+const helpers_1 = require("./helpers");
+function registerErdRoutes(router, ctx) {
+    const { db } = ctx;
+    router.get('/api/erd', async (_req, res) => {
+        try {
+            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 tableDetails = 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: tableDetails });
+        }
+        catch (err) {
+            (0, helpers_1.fail)(res, err.message ?? 'Unknown error.', 500);
+        }
+    });
+}

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

@@ -1,42 +1 @@
-import type { Request, Response } from 'express';
-import type { IDatabase, TableInfoData, WhereClause } from '../../db/index';
-import type { Logger } from '../../utils/logger';
-import { type ColumnPlan } from '../../data/index';
-export interface ApiContext {
-    db: IDatabase;
-    logger: Logger;
-}
-export declare function ok(res: Response, data: unknown, status?: number): Response;
-export declare function fail(res: Response, error: string, status?: number): Response;
-export declare function 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;
-};
-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;
-}>;
+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} from '../../data/index';export interface ApiContext{db:IDatabase;logger:Logger;}export declare function ok(res:Response,data:unknown,status?:number):Response;export declare function fail(res:Response,error:string,status?:number,details?:Record<string,unknown>|null):Response;export declare function 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;};export declare function parseChainSeedRequest(body:unknown):{scope:ErChainScope;counts:Record<string,number>;plans:Record<string,Record<string,ColumnPlan>>;truncate:boolean;};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/helpers.js

@@ -9,6 +9,7 @@ exports.buildFields = buildFields;
 exports.buildUpdateFields = buildUpdateFields;
 exports.pkWhere = pkWhere;
 exports.parseSeedRequest = parseSeedRequest;
+exports.parseChainSeedRequest = parseChainSeedRequest;
 exports.resolvePkRows = resolvePkRows;
 exports.computeBulkImpact = computeBulkImpact;
 const common_1 = require("../../utils/common");
@@ -17,8 +18,8 @@ const generator_1 = require("../../sql/generator");
 function ok(res, data, status = 200) {
     return res.status(status).json({ success: true, data });
 }
-function fail(res, error, status = 400) {
-    return res.status(status).json({ success: false, error });
+function fail(res, error, status = 400, details) {
+    return res.status(status).json({ success: false, error, ...(details ? { details } : {}) });
 }
 function wrap(fn) {
     return async (req, res) => {
@@ -89,6 +90,36 @@ function parseSeedRequest(body) {
     }
     return { count, plan, truncate };
 }
+function parseChainSeedRequest(body) {
+    const b = (body ?? {});
+    const scope = b.scope === 'ancestors' || b.scope === 'descendants' || b.scope === 'all' || b.scope === 'single'
+        ? b.scope
+        : 'chain';
+    const truncate = Boolean(b.truncate);
+    const counts = {};
+    if (b.counts && typeof b.counts === 'object') {
+        for (const [table, rawN] of Object.entries(b.counts)) {
+            const n = Number.parseInt(String(rawN), 10);
+            if (Number.isFinite(n) && n > 0)
+                counts[table] = Math.min(2000, n);
+        }
+    }
+    const plans = {};
+    if (b.plans && typeof b.plans === 'object') {
+        for (const [table, tablePlans] of Object.entries(b.plans)) {
+            if (tablePlans && typeof tablePlans === 'object') {
+                const pMap = {};
+                for (const [col, v] of Object.entries(tablePlans)) {
+                    const p = (0, index_1.sanitizeColumnPlan)(v);
+                    if (p)
+                        pMap[col] = p;
+                }
+                plans[table] = pMap;
+            }
+        }
+    }
+    return { scope, counts, plans, truncate };
+}
 function resolvePkRows(info, ids) {
     const list = Array.isArray(ids) ? ids : ids == null ? [] : [ids];
     const out = [];
@@ -130,4 +161,3 @@ async function computeBulkImpact(db, info, wheres) {
     const total = results.reduce((acc, r) => acc + r.count, 0);
     return { references: results, total };
 }
-//# sourceMappingURL=helpers.js.map

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

@@ -1,3 +1 @@
-import type { Router } from 'express';
-import { type ApiContext } from './helpers';
-export declare function registerImportExportRoutes(router: Router, ctx: ApiContext): void;
+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

@@ -6,7 +6,6 @@ const csv_1 = require("../../utils/csv");
 const helpers_1 = require("./helpers");
 function registerImportExportRoutes(router, ctx) {
     const { db } = ctx;
-    // ---- Export / Import ---------------------------------------------------
     router.get('/api/tables/:table/export', (0, helpers_1.wrap)(async (req, res) => {
         const info = await (0, helpers_1.requireTable)(db, req.params.table);
         if (!info)
@@ -82,4 +81,3 @@ function registerImportExportRoutes(router, ctx) {
         res.send((0, csv_1.toCsv)(rows, columns));
     }));
 }
-//# sourceMappingURL=import-export.js.map

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

@@ -1,4 +1 @@
-import type { Router } from 'express';
-import { type ApiContext } from './helpers';
-export { type ApiContext } from './helpers';
-export declare function registerApi(router: Router, ctx: ApiContext): void;
+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

@@ -6,11 +6,10 @@ 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) {
     const { db } = ctx;
-    // In read-only mode every mutating request is rejected (GET, the generate-only
-    // preview endpoints and the query runner stay available; the query runner
-    // rejects write statements itself).
     router.use((req, res, next) => {
         if (!db.isReadOnly || req.method === 'GET')
             return next();
@@ -33,5 +32,17 @@ function registerApi(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/ddl', async (_req, res) => {
+        try {
+            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) });
+        }
+    });
 }
-//# sourceMappingURL=index.js.map

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

@@ -1,3 +1 @@
-import type { Router } from 'express';
-import { type ApiContext } from './helpers';
-export declare function registerQueryRoutes(router: Router, ctx: ApiContext): void;
+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

@@ -2,24 +2,25 @@
 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) {
     const { db } = ctx;
-    // ---- Query runner ------------------------------------------------------
     router.post('/api/query', (0, helpers_1.wrap)(async (req, res) => {
         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);
-        // Multi-statement script detection
         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)
-                return (0, helpers_1.fail)(res, r.error ?? 'Query failed.', 400);
+            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.',
@@ -27,19 +28,22 @@ function registerQueryRoutes(router, ctx) {
         }
         if (kind === 'select' || kind === 'read' || kind === 'count') {
             const r = await db.all(rawSql);
-            if (!r.success)
-                return (0, helpers_1.fail)(res, r.error ?? 'Query failed.', 400);
+            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);
             const columns = rows.length ? Object.keys(rows[0]) : [];
             return (0, helpers_1.ok)(res, { kind: 'select', columns, rows });
         }
-        // write statement
         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)
-            return (0, helpers_1.fail)(res, r.error ?? 'Query failed.', 400);
+        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',
@@ -47,7 +51,6 @@ function registerQueryRoutes(router, ctx) {
             message: changes != null ? `${changes} row(s) affected.` : 'Statement executed successfully.',
         });
     }));
-    // ---- Saved queries -----------------------------------------------------
     router.get('/api/queries', (0, helpers_1.wrap)(async (_req, res) => {
         const r = await db.listSavedQueries();
         if (!r.success)
@@ -73,4 +76,3 @@ function registerQueryRoutes(router, ctx) {
         (0, helpers_1.ok)(res, { message: 'Query deleted.' });
     }));
 }
-//# sourceMappingURL=query.js.map

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

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

package/dist/routes/api/rows.js

@@ -8,7 +8,6 @@ const generator_1 = require("../../sql/generator");
 const helpers_1 = require("./helpers");
 function registerRowRoutes(router, ctx) {
     const { db } = ctx;
-    // ---- Rows --------------------------------------------------------------
     router.get('/api/tables/:table/rows', (0, helpers_1.wrap)(async (req, res) => {
         const page = Number.parseInt(String(req.query.page ?? '1'), 10);
         const limit = Number.parseInt(String(req.query.limit ?? '50'), 10);
@@ -36,7 +35,6 @@ function registerRowRoutes(router, ctx) {
             return (0, helpers_1.fail)(res, r.error ?? 'Failed to count rows.');
         (0, helpers_1.ok)(res, { count: r.data });
     }));
-    // Fetch single row
     router.get('/api/tables/:table/row/:id', (0, helpers_1.wrap)(async (req, res) => {
         const info = await (0, helpers_1.requireTable)(db, req.params.table);
         if (!info)
@@ -51,7 +49,6 @@ function registerRowRoutes(router, ctx) {
             return (0, helpers_1.fail)(res, 'Row not found.', 404);
         (0, helpers_1.ok)(res, (0, common_1.normalizeRow)(r.data));
     }));
-    // Serve raw BLOB binary data with auto-detected Content-Type and download support
     router.get('/api/tables/:table/row/:id/blob/:column', (0, helpers_1.wrap)(async (req, res) => {
         const info = await (0, helpers_1.requireTable)(db, req.params.table);
         if (!info)
@@ -89,7 +86,6 @@ function registerRowRoutes(router, ctx) {
         }
         res.end(buf);
     }));
-    // Return BLOB metadata and formatted hex dump
     router.get('/api/tables/:table/row/:id/blob/:column/meta', (0, helpers_1.wrap)(async (req, res) => {
         const info = await (0, helpers_1.requireTable)(db, req.params.table);
         if (!info)
@@ -110,7 +106,6 @@ function registerRowRoutes(router, ctx) {
         const meta = (0, datatype_1.analyzeBlob)(rawVal);
         (0, helpers_1.ok)(res, { isNull: false, ...meta });
     }));
-    // Update BLOB binary value directly (accepts Base64 or Hex payload)
     router.put('/api/tables/:table/row/:id/blob/:column', (0, helpers_1.wrap)(async (req, res) => {
         const info = await (0, helpers_1.requireTable)(db, req.params.table);
         if (!info)
@@ -123,7 +118,6 @@ function registerRowRoutes(router, ctx) {
         if (req.body?.data !== undefined) {
             const format = req.body.format || 'base64';
             if (format === 'base64') {
-                // Strip data:image/...;base64, prefix if present
                 const base64Str = String(req.body.data).replace(/^data:[^;]+;base64,/, '');
                 buf = Buffer.from(base64Str, 'base64');
             }
@@ -143,7 +137,6 @@ function registerRowRoutes(router, ctx) {
             return (0, helpers_1.fail)(res, updateRes.error ?? 'Failed to update BLOB.');
         (0, helpers_1.ok)(res, { message: `Updated BLOB in column "${colName}".`, size: buf.length });
     }));
-    // Preview generated INSERT SQL without executing
     router.post('/api/tables/:table/rows/generate', (0, helpers_1.wrap)(async (req, res) => {
         const info = await (0, helpers_1.requireTable)(db, req.params.table);
         if (!info)
@@ -154,7 +147,6 @@ function registerRowRoutes(router, ctx) {
         const sql = (0, generator_1.generateInsert)(req.params.table, fields);
         (0, helpers_1.ok)(res, { sql });
     }));
-    // Preview generated UPDATE SQL without executing
     const generateUpdateHandler = (0, helpers_1.wrap)(async (req, res) => {
         const info = await (0, helpers_1.requireTable)(db, req.params.table);
         if (!info)
@@ -270,7 +262,6 @@ function registerRowRoutes(router, ctx) {
     });
     router.delete('/api/tables/:table/row/:id', deleteSingleRowHandler);
     router.delete('/api/tables/:table/rows', deleteSingleRowHandler);
-    // ---- Row references ----------------------------------------------------
     router.get('/api/tables/:table/rows/:id/references', (0, helpers_1.wrap)(async (req, res) => {
         const info = await (0, helpers_1.requireTable)(db, req.params.table);
         if (!info)
@@ -311,7 +302,6 @@ function registerRowRoutes(router, ctx) {
         }
         (0, helpers_1.ok)(res, { references: results });
     }));
-    // ---- Bulk row operations -----------------------------------------------
     router.post('/api/tables/:table/rows/bulk-delete', (0, helpers_1.wrap)(async (req, res) => {
         const info = await (0, helpers_1.requireTable)(db, req.params.table);
         if (!info)
@@ -370,4 +360,3 @@ function registerRowRoutes(router, ctx) {
         res.send((0, csv_1.toCsv)(rows, columns));
     }));
 }
-//# sourceMappingURL=rows.js.map

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

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

package/dist/routes/api/seed.js

@@ -6,22 +6,18 @@ const index_1 = require("../../data/index");
 const helpers_1 = require("./helpers");
 function registerSeedRoutes(router, ctx) {
     const { db } = ctx;
-    // ---- Data generator / seeder ------------------------------------------
-    // Per-column generator config (strategies + detected defaults) for the "Seed data" page
     router.get('/api/tables/:table/seed/config', (0, helpers_1.wrap)(async (req, res) => {
         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);
         (0, helpers_1.ok)(res, { table: req.params.table, columns: (0, index_1.buildColumnConfigs)(info), maxRows: index_1.MAX_SEED_ROWS });
     }));
-    // Legacy alias for seed config
     router.get('/api/tables/:table/seed/plan', (0, helpers_1.wrap)(async (req, res) => {
         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);
         (0, helpers_1.ok)(res, { table: req.params.table, columns: (0, index_1.buildColumnConfigs)(info), maxRows: index_1.MAX_SEED_ROWS });
     }));
-    // Preview: generate the rows and return the INSERT statements without executing them
     router.post('/api/tables/:table/seed/generate', (0, helpers_1.wrap)(async (req, res) => {
         const info = await (0, helpers_1.requireTable)(db, req.params.table);
         if (!info)
@@ -37,7 +33,6 @@ function registerSeedRoutes(router, ctx) {
             warnings: gen.warnings,
         });
     }));
-    // Interactive grid preview
     router.post('/api/tables/:table/seed/preview', (0, helpers_1.wrap)(async (req, res) => {
         const info = await (0, helpers_1.requireTable)(db, req.params.table);
         if (!info)
@@ -51,7 +46,6 @@ function registerSeedRoutes(router, ctx) {
             warnings: gen.warnings,
         });
     }));
-    // Insert the generated rows inside a single transaction
     router.post('/api/tables/:table/seed', (0, helpers_1.wrap)(async (req, res) => {
         const info = await (0, helpers_1.requireTable)(db, req.params.table);
         if (!info)
@@ -65,7 +59,7 @@ function registerSeedRoutes(router, ctx) {
                 return (0, helpers_1.fail)(res, clearRes.error ?? 'Failed to clear table before seeding.', 400);
             }
         }
-        const gen = await (0, index_1.generateRows)(db, info, configs, count, plan);
+        const gen = await (0, index_1.generateRows)(db, info, configs, count, plan, truncate);
         const result = await db.insertRows(req.params.table, gen.rows);
         if (!result.success)
             return (0, helpers_1.fail)(res, result.error ?? 'Seed failed.', 400);
@@ -78,5 +72,82 @@ function registerSeedRoutes(router, ctx) {
             elapsedMs,
         }, 201);
     }));
+    router.get('/api/tables/:table/seed/chain', (0, helpers_1.wrap)(async (req, res) => {
+        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 rawScope = String(req.query.scope ?? 'chain');
+        const scope = rawScope === 'ancestors' || rawScope === 'descendants' || rawScope === 'all' || rawScope === 'single'
+            ? rawScope
+            : 'chain';
+        const config = await (0, index_1.getErChainConfig)(db, req.params.table, scope);
+        (0, helpers_1.ok)(res, config);
+    }));
+    router.post('/api/tables/:table/seed/chain/preview', (0, helpers_1.wrap)(async (req, res) => {
+        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 { scope, counts, plans } = (0, helpers_1.parseChainSeedRequest)(req.body);
+        const config = await (0, index_1.getErChainConfig)(db, req.params.table, scope);
+        const previewCounts = {};
+        for (const t of config.tables) {
+            previewCounts[t.name] = Math.min(50, counts[t.name] ?? t.suggestedCount ?? 10);
+        }
+        const gen = await (0, index_1.generateChainRows)(db, config, plans, previewCounts);
+        (0, helpers_1.ok)(res, gen);
+    }));
+    router.post('/api/tables/:table/seed/chain/generate', (0, helpers_1.wrap)(async (req, res) => {
+        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 { scope, counts, plans } = (0, helpers_1.parseChainSeedRequest)(req.body);
+        const config = await (0, index_1.getErChainConfig)(db, req.params.table, scope);
+        const gen = await (0, index_1.generateChainRows)(db, config, plans, counts);
+        (0, helpers_1.ok)(res, gen);
+    }));
+    router.post('/api/tables/:table/seed/chain', (0, helpers_1.wrap)(async (req, res) => {
+        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 { scope, counts, plans, truncate } = (0, helpers_1.parseChainSeedRequest)(req.body);
+        const config = await (0, index_1.getErChainConfig)(db, req.params.table, scope);
+        const gen = await (0, index_1.generateChainRows)(db, config, plans, counts, truncate);
+        const exec = await (0, index_1.executeChainInsert)(db, gen, truncate);
+        (0, helpers_1.ok)(res, {
+            message: `${truncate ? 'Cleared tables in reverse order and seeded' : 'Seeded'} ${exec.totalInserted} row(s) across ${Object.keys(exec.inserted).length} table(s) in ${exec.elapsedMs}ms.`,
+            inserted: exec.inserted,
+            totalInserted: exec.totalInserted,
+            elapsedMs: exec.elapsedMs,
+            warnings: exec.warnings,
+        }, 201);
+    }));
+    router.get('/api/seed/chain', (0, helpers_1.wrap)(async (req, res) => {
+        const rawRoot = String(req.query.table ?? '');
+        const rawScope = String(req.query.scope ?? (rawRoot ? 'chain' : 'all'));
+        const scope = rawScope === 'ancestors' || rawScope === 'descendants' || rawScope === 'all' || rawScope === 'single'
+            ? rawScope
+            : 'all';
+        const rootTable = rawRoot || (await db.listTables()).data?.[0]?.name || '';
+        if (!rootTable)
+            return (0, helpers_1.fail)(res, 'No tables found in database.', 404);
+        const config = await (0, index_1.getErChainConfig)(db, rootTable, scope);
+        (0, helpers_1.ok)(res, config);
+    }));
+    router.post('/api/seed/chain', (0, helpers_1.wrap)(async (req, res) => {
+        const { scope, counts, plans, truncate } = (0, helpers_1.parseChainSeedRequest)(req.body);
+        const rawRoot = String(req.body?.rootTable ?? '');
+        const rootTable = rawRoot || (await db.listTables()).data?.[0]?.name || '';
+        if (!rootTable)
+            return (0, helpers_1.fail)(res, 'No tables found in database.', 404);
+        const config = await (0, index_1.getErChainConfig)(db, rootTable, scope);
+        const gen = await (0, index_1.generateChainRows)(db, config, plans, counts, truncate);
+        const exec = await (0, index_1.executeChainInsert)(db, gen, truncate);
+        (0, helpers_1.ok)(res, {
+            message: `${truncate ? 'Cleared tables in reverse order and seeded' : 'Seeded'} ${exec.totalInserted} row(s) across ${Object.keys(exec.inserted).length} table(s) in ${exec.elapsedMs}ms.`,
+            inserted: exec.inserted,
+            totalInserted: exec.totalInserted,
+            elapsedMs: exec.elapsedMs,
+            warnings: exec.warnings,
+        }, 201);
+    }));
 }
-//# sourceMappingURL=seed.js.map

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

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

package/dist/routes/api/tables.js

@@ -5,7 +5,6 @@ const generator_1 = require("../../sql/generator");
 const helpers_1 = require("./helpers");
 function registerTableRoutes(router, ctx) {
     const { db } = ctx;
-    // ---- Tables ------------------------------------------------------------
     router.get('/api/tables', (0, helpers_1.wrap)(async (_req, res) => {
         const r = await db.listTables();
         if (!r.success)
@@ -40,7 +39,6 @@ function registerTableRoutes(router, ctx) {
                 }
             }
             catch {
-                // FK option loading is best-effort.
             }
         }
         (0, helpers_1.ok)(res, options);
@@ -68,7 +66,83 @@ function registerTableRoutes(router, ctx) {
             return (0, helpers_1.fail)(res, r.error ?? 'Failed to drop table.');
         (0, helpers_1.ok)(res, { message: `Table "${req.params.table}" dropped.` });
     }));
-    // Preview generated CREATE TABLE SQL without executing
+    router.post('/api/tables/bulk-drop', (0, helpers_1.wrap)(async (req, res) => {
+        const tables = Array.isArray(req.body?.tables)
+            ? req.body.tables.filter((t) => typeof t === 'string' && t.trim().length > 0)
+            : [];
+        const force = Boolean(req.body?.force);
+        if (tables.length === 0)
+            return (0, helpers_1.fail)(res, 'No tables specified.');
+        const dropped = [];
+        const failed = [];
+        if (force && db.dialect === 'sqlite') {
+            await db.run('PRAGMA foreign_keys = OFF');
+        }
+        for (const table of tables) {
+            try {
+                if (force && db.dialect === 'postgres') {
+                    const r = await db.run(`DROP TABLE IF EXISTS ${(0, generator_1.quoteIdentifier)(table)} CASCADE`);
+                    if (!r.success)
+                        throw new Error(r.error ?? 'Failed to drop table.');
+                }
+                else {
+                    const r = await db.dropTable(table);
+                    if (!r.success)
+                        throw new Error(r.error ?? 'Failed to drop table.');
+                }
+                dropped.push(table);
+            }
+            catch (err) {
+                failed.push({ table, error: err.message });
+            }
+        }
+        if (force && db.dialect === 'sqlite') {
+            await db.run('PRAGMA foreign_keys = ON');
+        }
+        (0, helpers_1.ok)(res, {
+            dropped,
+            failed,
+            message: `Dropped ${dropped.length} table(s)${failed.length ? `, ${failed.length} failed` : ''}.`,
+        });
+    }));
+    router.post('/api/tables/bulk-truncate', (0, helpers_1.wrap)(async (req, res) => {
+        const tables = Array.isArray(req.body?.tables)
+            ? req.body.tables.filter((t) => typeof t === 'string' && t.trim().length > 0)
+            : [];
+        const force = Boolean(req.body?.force);
+        if (tables.length === 0)
+            return (0, helpers_1.fail)(res, 'No tables specified.');
+        const cleared = [];
+        const failed = [];
+        if (force && db.dialect === 'sqlite') {
+            await db.run('PRAGMA foreign_keys = OFF');
+        }
+        for (const table of tables) {
+            try {
+                let r;
+                if (force && db.dialect === 'postgres') {
+                    r = await db.run(`TRUNCATE ${(0, generator_1.quoteIdentifier)(table)} RESTART IDENTITY CASCADE`);
+                }
+                else {
+                    r = await db.run(`DELETE FROM ${(0, generator_1.quoteIdentifier)(table)}`);
+                }
+                if (!r.success)
+                    throw new Error(r.error ?? 'Failed to clear table.');
+                cleared.push(table);
+            }
+            catch (err) {
+                failed.push({ table, error: err.message });
+            }
+        }
+        if (force && db.dialect === 'sqlite') {
+            await db.run('PRAGMA foreign_keys = ON');
+        }
+        (0, helpers_1.ok)(res, {
+            cleared,
+            failed,
+            message: `Cleared ${cleared.length} table(s)${failed.length ? `, ${failed.length} failed` : ''}.`,
+        });
+    }));
     router.post('/api/tables/generate', (0, helpers_1.wrap)(async (req, res) => {
         const name = String(req.body?.name ?? '').trim();
         const columns = (req.body?.columns ?? []);
@@ -105,7 +179,6 @@ function registerTableRoutes(router, ctx) {
     });
     router.post('/api/tables', createTableHandler);
     router.post('/api/tables/create', createTableHandler);
-    // ---- Columns -----------------------------------------------------------
     router.post('/api/tables/:table/columns', (0, helpers_1.wrap)(async (req, res) => {
         const col = req.body;
         if (!col || !col.name)
@@ -139,7 +212,6 @@ function registerTableRoutes(router, ctx) {
             return (0, helpers_1.fail)(res, r.error ?? 'Failed to drop column.');
         (0, helpers_1.ok)(res, { message: `Column "${req.params.column}" dropped.` });
     }));
-    // ---- Indexes -----------------------------------------------------------
     router.post('/api/tables/:table/indexes', (0, helpers_1.wrap)(async (req, res) => {
         const def = req.body;
         if (!def || !Array.isArray(def.columns) || def.columns.length === 0) {
@@ -157,4 +229,3 @@ function registerTableRoutes(router, ctx) {
         (0, helpers_1.ok)(res, { message: `Index "${req.params.index}" dropped.` });
     }));
 }
-//# sourceMappingURL=tables.js.map