admindb 2.4.0 → 2.5.0

package/dist/modules/rows/rows.routes.js

@@ -0,0 +1,555 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRowRoutes = registerRowRoutes;
+const common_1 = require("../../utils/common");
+const router_1 = require("../../core/router");
+const tables_service_1 = require("../tables/tables.service");
+const schema_service_1 = require("../schema/schema.service");
+const index_1 = require("./index");
+function registerRowRoutes(router, ctx) {
+    router.get('/tables/:db/:table', async (req, res, next) => {
+        try {
+            const db = ctx.getContext(req);
+            const dbId = req.params.db;
+            const table = req.params.table;
+            res.locals.dbId = dbId;
+            const tablesList = await tables_service_1.TableService.listTables(db);
+            const allNames = tablesList.map((t) => t.name);
+            (0, router_1.initPageLocals)(res, db, dbId, allNames);
+            const info = await tables_service_1.TableService.getTableInfo(db, table);
+            if (!info) {
+                return (0, router_1.notFound)(res, `Table "${table}" does not exist.`);
+            }
+            const page = Math.max(1, Number.parseInt(String(req.query.page ?? '1'), 10) || 1);
+            const pageSize = Math.max(1, Number.parseInt(String(req.query.size ?? '50'), 10) || 50);
+            const orderBy = req.query.orderBy ? String(req.query.orderBy) : undefined;
+            const orderDir = String(req.query.orderDir ?? 'asc').toLowerCase() === 'desc' ? 'desc' : 'asc';
+            const filters = (0, common_1.parseFilters)(req.query.f);
+            const filterQS = (0, common_1.filtersToQS)(filters);
+            const [count, paginated, refs] = await Promise.all([
+                index_1.RowsService.getRowCount(db, table, filters),
+                index_1.RowsService.getPaginatedRows(db, table, { page, limit: pageSize, orderBy, orderDir, filters }),
+                schema_service_1.SchemaService.getReferencingTables(db, table),
+            ]);
+            const rawRows = paginated.rows;
+            const pages = Math.max(1, Math.ceil(count / pageSize));
+            const basePath = String(res.locals.basePath ?? '');
+            const sizes = [25, 50, 100, 250];
+            const colHeaders = info.columns.map((c) => {
+                const active = c.name === orderBy;
+                const nextDir = active ? (orderDir === 'asc' ? 'desc' : 'asc') : 'asc';
+                const qs = `page=1&size=${pageSize}&orderBy=${encodeURIComponent(c.name)}&orderDir=${nextDir}`;
+                return {
+                    name: c.name,
+                    pk: c.pk,
+                    type: c.type,
+                    active,
+                    dir: active ? orderDir : null,
+                    href: `${basePath}/tables/${encodeURIComponent(dbId)}/${encodeURIComponent(table)}?${qs}${filterQS ? `&${filterQS}` : ''}`,
+                };
+            });
+            const refColumns = refs
+                .filter((r) => !r.table.startsWith('_'))
+                .map((rt) => ({ table: rt.table, from: rt.refs[0]?.from ?? '', to: rt.refs[0]?.to ?? '' }));
+            const countMap = await tables_service_1.TableService.getIncomingForeignKeyCounts(db, rawRows, refColumns);
+            const rows = (0, index_1.buildDisplayRows)(rawRows, info, dbId, table, basePath).map((dr, i) => {
+                const raw = rawRows[i];
+                const rowRefs = refColumns.map((col) => {
+                    const v = raw[col.to];
+                    return {
+                        table: col.table,
+                        from: col.from,
+                        to: col.to,
+                        value: v == null ? '' : String(v),
+                        count: v == null ? 0 : (countMap.get(col.table)?.get(String(v)) ?? 0),
+                    };
+                });
+                return { ...dr, refs: rowRefs };
+            });
+            res.locals.currentTable = table;
+            res.render('pages/table', {
+                title: table,
+                dbId,
+                table,
+                info,
+                rows,
+                count,
+                page,
+                pageSize,
+                pages,
+                pkCols: info.primaryKey,
+                colNames: info.columns.map((c) => c.name),
+                colHeaders,
+                refColumns,
+                hasPk: true,
+                orderBy: orderBy ?? '',
+                orderDir,
+                sizes,
+                filters,
+                filterQS,
+                firstRow: count === 0 ? 0 : (page - 1) * pageSize + 1,
+                lastRow: Math.min(page * pageSize, count),
+                browseConfig: {
+                    dbId,
+                    table,
+                    filters,
+                    pkCols: info.primaryKey.length ? info.primaryKey : ['_rowid_'],
+                    hasPk: true,
+                    readonly: db.isReadOnly,
+                },
+            });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.get('/tables/:db/:table/rows/new', async (req, res, next) => {
+        try {
+            const db = ctx.getContext(req);
+            const dbId = req.params.db;
+            const table = req.params.table;
+            res.locals.dbId = dbId;
+            const tablesList = await tables_service_1.TableService.listTables(db);
+            const allNames = tablesList.map((t) => t.name);
+            (0, router_1.initPageLocals)(res, db, dbId, allNames);
+            const info = await tables_service_1.TableService.getTableInfo(db, table);
+            if (!info) {
+                return (0, router_1.notFound)(res, `Table "${table}" does not exist.`);
+            }
+            const pkColumns = info.primaryKey;
+            res.locals.currentTable = table;
+            res.render('pages/form', {
+                title: `New row · ${table}`,
+                dbId,
+                table,
+                mode: 'insert',
+                pk: null,
+                pkColumns,
+                infoSummary: `${info.columns.length} column(s)` + (pkColumns.length ? ` · PK: ${pkColumns.join(', ')}` : ''),
+                config: { dbId, table, mode: 'insert', pk: null, pkColumns },
+            });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.get('/tables/:db/:table/rows/:id/edit', async (req, res, next) => {
+        try {
+            const db = ctx.getContext(req);
+            const dbId = req.params.db;
+            const table = req.params.table;
+            res.locals.dbId = dbId;
+            const tablesList = await tables_service_1.TableService.listTables(db);
+            const allNames = tablesList.map((t) => t.name);
+            (0, router_1.initPageLocals)(res, db, dbId, allNames);
+            const info = await tables_service_1.TableService.getTableInfo(db, table);
+            if (!info) {
+                return (0, router_1.notFound)(res, `Table "${table}" does not exist.`);
+            }
+            const pkColumns = info.primaryKey.length ? info.primaryKey : ['_rowid_'];
+            const pk = (0, common_1.decodePk)(req.params.id);
+            if (pk.length !== pkColumns.length) {
+                return (0, router_1.notFound)(res, 'Invalid row identifier.');
+            }
+            res.locals.currentTable = table;
+            res.render('pages/form', {
+                title: `Edit row · ${table}`,
+                dbId,
+                table,
+                mode: 'edit',
+                pk: req.params.id,
+                pkColumns,
+                infoSummary: `${info.columns.length} column(s)` + (info.primaryKey.length ? ` · PK: ${info.primaryKey.join(', ')}` : ''),
+                config: { dbId, table, mode: 'edit', pk: req.params.id, pkColumns },
+            });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.get('/api/tables/:db/:table/rows', (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const page = Number.parseInt(String(req.query.page ?? '1'), 10);
+        const limit = Number.parseInt(String(req.query.limit ?? '50'), 10);
+        const orderBy = req.query.orderBy ? String(req.query.orderBy) : undefined;
+        const orderDir = req.query.orderDir === 'desc' ? 'desc' : 'asc';
+        const filters = (0, common_1.parseFilters)(req.query.f);
+        try {
+            const data = await index_1.RowsService.getPaginatedRows(db, req.params.table, {
+                page,
+                limit,
+                orderBy,
+                orderDir,
+                filters,
+            });
+            (0, router_1.ok)(res, data);
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message ?? 'Failed to load rows.');
+        }
+    }));
+    router.get('/api/tables/:db/:table/cursor-rows', (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const cursor = req.query.cursor ? String(req.query.cursor) : undefined;
+        const limit = Number.parseInt(String(req.query.limit ?? '50'), 10);
+        const orderBy = req.query.orderBy ? String(req.query.orderBy) : undefined;
+        const orderDir = req.query.orderDir === 'desc' ? 'desc' : 'asc';
+        const filters = (0, common_1.parseFilters)(req.query.f);
+        try {
+            const data = await index_1.RowsService.getCursorPaginatedRows(db, req.params.table, {
+                cursor,
+                limit,
+                orderBy,
+                orderDir,
+                filters,
+            });
+            (0, router_1.ok)(res, data);
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message ?? 'Failed to load rows.');
+        }
+    }));
+    router.get('/api/tables/:db/:table/rows/count', (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const filters = (0, common_1.parseFilters)(req.query.f);
+        try {
+            const count = await index_1.RowsService.getRowCount(db, req.params.table, filters);
+            (0, router_1.ok)(res, { count });
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message ?? 'Failed to count rows.');
+        }
+    }));
+    router.get('/api/tables/:db/:table/row/:id', (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        const where = (0, index_1.pkWhere)(info, req.params.id);
+        if (!where)
+            return (0, router_1.fail)(res, 'Invalid primary key.', 400);
+        try {
+            const row = await index_1.RowsService.getRow(db, req.params.table, where);
+            if (!row)
+                return (0, router_1.fail)(res, 'Row not found.', 404);
+            (0, router_1.ok)(res, row);
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message ?? 'Failed to load row.');
+        }
+    }));
+    router.get('/api/tables/:db/:table/row/:id/blob/:column', (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        const where = (0, index_1.pkWhere)(info, req.params.id);
+        if (!where)
+            return (0, router_1.fail)(res, 'Invalid primary key.', 400);
+        try {
+            const blobResult = await index_1.RowsService.getBlob(db, req.params.table, where, req.params.column);
+            if (!blobResult) {
+                return (0, router_1.fail)(res, 'Column value is NULL.', 404);
+            }
+            const { buffer, mimeInfo } = blobResult;
+            res.setHeader('Content-Type', mimeInfo.mime);
+            res.setHeader('Content-Length', buffer.length);
+            res.setHeader('Cache-Control', 'no-cache');
+            if (req.query.download === '1' || req.query.download === 'true') {
+                const filename = `${req.params.table}_${req.params.column}_${req.params.id}.${mimeInfo.ext}`;
+                res.setHeader('Content-Disposition', `attachment; filename="${filename}"`);
+            }
+            res.end(buffer);
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message ?? 'Failed to load row.');
+        }
+    }));
+    router.get('/api/tables/:db/:table/row/:id/blob/:column/meta', (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        const where = (0, index_1.pkWhere)(info, req.params.id);
+        if (!where)
+            return (0, router_1.fail)(res, 'Invalid primary key.', 400);
+        try {
+            const meta = await index_1.RowsService.getBlobMeta(db, req.params.table, where, req.params.column);
+            if (!meta)
+                return (0, router_1.fail)(res, 'Row not found.', 404);
+            (0, router_1.ok)(res, meta);
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message ?? 'Failed to load row.');
+        }
+    }));
+    router.put('/api/tables/:db/:table/row/:id/blob/:column', (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        const where = (0, index_1.pkWhere)(info, req.params.id);
+        if (!where)
+            return (0, router_1.fail)(res, 'Invalid primary key.', 400);
+        const colName = req.params.column;
+        if (req.body?.data === undefined) {
+            return (0, router_1.fail)(res, 'Payload data is required.');
+        }
+        try {
+            const size = await index_1.RowsService.updateBlob(db, req.params.table, where, colName, req.body.data, req.body.format);
+            (0, router_1.ok)(res, { message: `Updated BLOB in column "${colName}".`, size });
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message ?? 'Failed to update BLOB.');
+        }
+    }));
+    router.post('/api/tables/:db/:table/rows/generate', (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        const fields = (0, index_1.buildFields)(info, req.body?.values ?? req.body ?? {});
+        try {
+            (0, router_1.ok)(res, { sql: index_1.RowsService.generateInsertSql(req.params.table, fields) });
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message);
+        }
+    }));
+    const generateUpdateHandler = (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        const id = req.params.id || (req.query.id ? String(req.query.id) : null);
+        if (!id)
+            return (0, router_1.fail)(res, 'Primary key id is required.');
+        const where = (0, index_1.pkWhere)(info, id);
+        if (!where)
+            return (0, router_1.fail)(res, 'Invalid primary key.', 400);
+        const nulls = Array.isArray(req.body?.nulls) ? req.body.nulls : [];
+        const fields = (0, index_1.buildUpdateFields)(info, req.body?.values ?? req.body ?? {}, nulls);
+        try {
+            (0, router_1.ok)(res, { sql: index_1.RowsService.generateUpdateSql(req.params.table, fields, where) });
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message);
+        }
+    });
+    router.put('/api/tables/:db/:table/row/:id/generate', generateUpdateHandler);
+    router.post('/api/tables/:db/:table/row/:id/generate', generateUpdateHandler);
+    router.put('/api/tables/:db/:table/rows/generate', generateUpdateHandler);
+    router.post('/api/tables/:db/:table/rows', (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        const isBatch = Array.isArray(req.body?.rows);
+        const rowList = isBatch
+            ? req.body.rows
+            : [req.body?.values ?? req.body ?? {}];
+        if (!rowList.length)
+            return (0, router_1.fail)(res, 'No rows provided.');
+        const fieldsList = rowList.map((row) => (0, index_1.buildFields)(info, row));
+        try {
+            if (!isBatch) {
+                const id = await index_1.RowsService.insertRow(db, req.params.table, fieldsList[0]);
+                return (0, router_1.ok)(res, { message: 'Row inserted.', id }, 201);
+            }
+            const inserted = await index_1.RowsService.insertRows(db, req.params.table, fieldsList);
+            (0, router_1.ok)(res, { message: `${inserted} row(s) inserted.`, inserted }, 201);
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message ?? 'Failed to insert row(s).');
+        }
+    }));
+    const updateSingleRowHandler = (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        const id = req.params.id || (req.query.id ? String(req.query.id) : null);
+        if (!id)
+            return (0, router_1.fail)(res, 'Primary key id is required.');
+        const where = (0, index_1.pkWhere)(info, id);
+        if (!where)
+            return (0, router_1.fail)(res, 'Invalid primary key.');
+        const nulls = Array.isArray(req.body?.nulls) ? req.body.nulls : [];
+        const fields = (0, index_1.buildUpdateFields)(info, req.body?.values ?? req.body ?? {}, nulls);
+        try {
+            await index_1.RowsService.updateRow(db, req.params.table, fields, where);
+            (0, router_1.ok)(res, { message: 'Row updated.' });
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message ?? 'Failed to update row.');
+        }
+    });
+    const bulkUpdateHandler = (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        if (Array.isArray(req.body?.updates)) {
+            const updates = req.body.updates;
+            if (!updates.length)
+                return (0, router_1.fail)(res, 'No updates provided.');
+            if (updates.length > index_1.MAX_BULK_ROWS)
+                return (0, router_1.fail)(res, `Cannot update more than ${index_1.MAX_BULK_ROWS} rows at once.`);
+            const rowUpdates = [];
+            for (const u of updates) {
+                if (!u.id)
+                    return (0, router_1.fail)(res, 'Every update requires an id.');
+                const where = (0, index_1.pkWhere)(info, String(u.id));
+                if (!where)
+                    return (0, router_1.fail)(res, `Invalid primary key: "${u.id}".`);
+                const nulls = Array.isArray(u.nulls) ? u.nulls.map(String) : [];
+                const fields = (0, index_1.buildUpdateFields)(info, u.values ?? {}, nulls);
+                if (fields.length)
+                    rowUpdates.push({ fields, where });
+            }
+            try {
+                const updated = await index_1.RowsService.updateRows(db, req.params.table, rowUpdates);
+                return (0, router_1.ok)(res, { message: updated ? `${updated} row(s) updated.` : 'No changes to apply.', updated });
+            }
+            catch (err) {
+                return (0, router_1.fail)(res, err.message ?? 'Failed to update rows.');
+            }
+        }
+        return updateSingleRowHandler(req, res);
+    });
+    router.put('/api/tables/:db/:table/row/:id', updateSingleRowHandler);
+    router.put('/api/tables/:db/:table/rows', bulkUpdateHandler);
+    router.post('/api/tables/:db/:table/rows/bulk-update', bulkUpdateHandler);
+    const deleteSingleRowHandler = (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        const id = req.params.id || (req.query.id ? String(req.query.id) : null);
+        if (!id)
+            return (0, router_1.fail)(res, 'Primary key id is required.');
+        const where = (0, index_1.pkWhere)(info, id);
+        if (!where)
+            return (0, router_1.fail)(res, 'Invalid primary key.');
+        try {
+            await index_1.RowsService.deleteRow(db, req.params.table, where);
+            (0, router_1.ok)(res, { message: 'Row deleted.' });
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message ?? 'Failed to delete row.');
+        }
+    });
+    router.delete('/api/tables/:db/:table/row/:id', deleteSingleRowHandler);
+    router.delete('/api/tables/:db/:table/rows', deleteSingleRowHandler);
+    router.get('/api/tables/:db/:table/rows/:id/references', (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        const where = (0, index_1.pkWhere)(info, req.params.id);
+        if (!where)
+            return (0, router_1.fail)(res, 'Invalid primary key.', 400);
+        try {
+            const references = await index_1.RowsService.getRowReferences(db, req.params.table, info, where);
+            (0, router_1.ok)(res, { references });
+        }
+        catch (err) {
+            const msg = err.message;
+            if (msg === 'Row not found.')
+                return (0, router_1.fail)(res, msg, 404);
+            (0, router_1.fail)(res, msg ?? 'Failed to fetch references.');
+        }
+    }));
+    router.post('/api/tables/:db/:table/rows/bulk-delete', (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        const ids = (req.body?.ids ?? []);
+        if (!Array.isArray(ids) || !ids.length)
+            return (0, router_1.fail)(res, 'No row IDs provided.');
+        if (ids.length > index_1.MAX_BULK_ROWS)
+            return (0, router_1.fail)(res, `Cannot delete more than ${index_1.MAX_BULK_ROWS} rows at once.`);
+        const wheres = (0, index_1.resolvePkRows)(info, ids);
+        if (!wheres)
+            return (0, router_1.fail)(res, 'Invalid or unresolvable row IDs.');
+        try {
+            const deleted = await index_1.RowsService.deleteRows(db, req.params.table, wheres);
+            (0, router_1.ok)(res, { message: `${deleted} row(s) deleted.`, deleted });
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message ?? 'Failed to delete rows.');
+        }
+    }));
+    router.post('/api/tables/:db/:table/rows/bulk-impact', (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        const ids = (req.body?.ids ?? []);
+        if (!Array.isArray(ids) || !ids.length)
+            return (0, router_1.ok)(res, { references: [], total: 0 });
+        const wheres = (0, index_1.resolvePkRows)(info, ids);
+        if (!wheres)
+            return (0, router_1.ok)(res, { references: [], total: 0 });
+        (0, router_1.ok)(res, await (0, index_1.computeBulkImpact)(db, info, wheres));
+    }));
+    router.post('/api/tables/:db/:table/rows/bulk-export', (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        const ids = (req.body?.ids ?? []);
+        if (!Array.isArray(ids) || !ids.length)
+            return (0, router_1.fail)(res, 'No row IDs provided.');
+        if (ids.length > index_1.MAX_BULK_ROWS)
+            return (0, router_1.fail)(res, `Cannot export more than ${index_1.MAX_BULK_ROWS} rows at once.`);
+        const wheres = (0, index_1.resolvePkRows)(info, ids);
+        if (!wheres)
+            return (0, router_1.fail)(res, 'Invalid or unresolvable row IDs.');
+        const format = String(req.body?.format ?? 'csv').toLowerCase() === 'json' ? 'json' : 'csv';
+        try {
+            const exp = await index_1.RowsService.exportBulkRows(db, req.params.table, info, wheres, format);
+            res.setHeader('Content-Type', exp.contentType);
+            res.setHeader('Content-Disposition', `attachment; filename="${exp.filename}"`);
+            res.send(exp.data);
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message ?? 'Failed to load rows.');
+        }
+    }));
+    router.get('/api/tables/:db/:table/export', (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        const format = String(req.query.format ?? 'csv').toLowerCase() === 'json' ? 'json' : 'csv';
+        const filters = (0, common_1.parseFilters)(req.query.f);
+        try {
+            const exp = await index_1.RowsService.streamExportTable(db, req.params.table, info, { filters, format });
+            res.setHeader('Content-Type', exp.contentType);
+            res.setHeader('Content-Disposition', `attachment; filename="${exp.filename}"`);
+            exp.stream.pipe(res);
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message ?? 'Failed to export table.');
+        }
+    }));
+    const importCsvHandler = (0, router_1.wrap)(async (req, res) => {
+        const db = ctx.getContext(req);
+        const info = await tables_service_1.TableService.getTableInfo(db, req.params.table);
+        if (!info)
+            return (0, router_1.fail)(res, `Table "${req.params.table}" does not exist.`, 404);
+        const csvText = typeof req.body === 'string' ? req.body : String(req.body?.csv ?? '');
+        try {
+            const inserted = await index_1.RowsService.importCsv(db, req.params.table, info, csvText);
+            (0, router_1.ok)(res, { message: `${inserted} row(s) imported.`, inserted });
+        }
+        catch (err) {
+            (0, router_1.fail)(res, err.message ?? 'Failed to import CSV.');
+        }
+    });
+    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);
+}

package/dist/modules/rows/rows.service.d.ts

@@ -0,0 +1 @@
+import type {TableInfoData,WhereClause,RowFilters} from '../../db/index';import type {DatabaseContext} from '../../core/context';export declare const MAX_BULK_ROWS=1000;export interface CursorPaginationOptions{cursor?:string|null;limit?:number;orderBy?:string;orderDir?:'asc'|'desc';filters?:RowFilters;}export interface CursorPaginatedResult{rows:Record<string,unknown>[];nextCursor:string|null;prevCursor:string|null;hasMore:boolean;limit:number;}export interface BulkImpactResult{references:{table:string; from :string;to:string;count:number;}[];total:number;}export interface RowReferenceResult{table:string; from :string;to:string;value?:unknown;columns?:string[];rows:Record<string,unknown>[];count?:number;total:number;}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):WhereClause[]|null;export declare function resolvePkRows(info:TableInfoData,ids:unknown):WhereClause[][]|null;export declare function computeBulkImpact(ctx:DatabaseContext,info:TableInfoData,wheres:WhereClause[][]):Promise<BulkImpactResult>;export declare function encodeCursor(values:Record<string,unknown>):string;export declare function decodeCursor(cursor:string):Record<string,unknown>|null;export declare class RowsService{static getPaginatedRows(ctx:DatabaseContext,table:string,options?:{page?:number;limit?:number;orderBy?:string;orderDir?:'asc'|'desc';filters?:RowFilters;}):Promise<{rows:Record<string,unknown>[];total:number;page:number;limit:number;}>;static getCursorPaginatedRows(ctx:DatabaseContext,table:string,options?:CursorPaginationOptions):Promise<CursorPaginatedResult>;static getRowCount(ctx:DatabaseContext,table:string,filters?:RowFilters):Promise<number>;static getRow(ctx:DatabaseContext,table:string,where:WhereClause[]):Promise<Record<string,unknown>|null>;static getBlob(ctx:DatabaseContext,table:string,where:WhereClause[],column:string):Promise<{buffer:Buffer<ArrayBufferLike>;mimeInfo:import("../..").MimeAnalysis;}|null>;static getBlobMeta(ctx:DatabaseContext,table:string,where:WhereClause[],column:string):Promise<({isNull:boolean;}&Partial<import("../..").BlobMetadata>)|null>;static updateBlob(ctx:DatabaseContext,table:string,where:WhereClause[],column:string,data:unknown,format?:string):Promise<number>;static generateInsertSql(table:string,fields:{column:string;value:unknown;}[]):string;static generateUpdateSql(table:string,fields:{column:string;value:unknown;}[],where:WhereClause[]):string;static insertRow(ctx:DatabaseContext,table:string,fields:{column:string;value:unknown;}[]):Promise<number|null|undefined>;static insertRows(ctx:DatabaseContext,table:string,fieldsList:{column:string;value:unknown;}[][]):Promise<number>;static updateRow(ctx:DatabaseContext,table:string,fields:{column:string;value:unknown;}[],where:WhereClause[]):Promise<void>;static updateRows(ctx:DatabaseContext,table:string,rowUpdates:{fields:WhereClause[];where:WhereClause[];}[]):Promise<number>;static deleteRow(ctx:DatabaseContext,table:string,where:WhereClause[]):Promise<void>;static deleteRows(ctx:DatabaseContext,table:string,wheres:WhereClause[][]):Promise<number>;static getRowReferences(ctx:DatabaseContext,table:string,info:TableInfoData,where:WhereClause[]):Promise<RowReferenceResult[]>;static exportTable(ctx:DatabaseContext,table:string,info:TableInfoData,options:{filters?:RowFilters;limit?:number;format:'csv'|'json';}):Promise<{data:string;contentType:string;filename:string;}>;static streamExportTable(ctx:DatabaseContext,table:string,info:TableInfoData,options:{filters?:RowFilters;format:'csv'|'json';chunkSize?:number;}):Promise<{stream:NodeJS.ReadableStream;contentType:string;filename:string;}>;static exportBulkRows(ctx:DatabaseContext,table:string,info:TableInfoData,wheres:WhereClause[][],format:'csv'|'json'):Promise<{data:string;contentType:string;filename:string;}>;static importCsv(ctx:DatabaseContext,table:string,info:TableInfoData,csvText:string):Promise<number>;static streamImportCsv(ctx:DatabaseContext,table:string,info:TableInfoData,csvStream:AsyncIterable<string|Buffer>,batchSize?:number):Promise<number>;}