admindb 1.0.1

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+import type { LogLevel } from './logger';
+export interface Config {
+    host: string;
+    port: number;
+    /** Single-database file (used when no multi-db sources are configured). */
+    dbPath: string;
+    /** Directory of managed database files (multi-db mode source 1). */
+    dbDir?: string;
+    /** Explicit database file locations (multi-db mode source 2). */
+    dbFiles?: string[];
+    basePath: string;
+    logLevel: LogLevel;
+    /** Open the database read-only (writes disabled). */
+    readonly: boolean;
+}
+/** Load configuration from environment variables with sensible defaults. */
+export declare function loadConfig(env?: NodeJS.ProcessEnv): Config;

package/dist/config.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+/** Load configuration from environment variables with sensible defaults. */
+function loadConfig(env = process.env) {
+    const port = Number.parseInt(env.PORT ?? '3000', 10);
+    return {
+        host: env.HOST ?? '0.0.0.0',
+        port: Number.isFinite(port) ? port : 3000,
+        dbPath: env.DB_PATH ?? 'admindb.db',
+        dbDir: env.DB_DIR ? String(env.DB_DIR) : undefined,
+        dbFiles: env.DB_FILES
+            ? String(env.DB_FILES)
+                .split(',')
+                .map((s) => s.trim())
+                .filter(Boolean)
+            : undefined,
+        basePath: (env.BASE_PATH ?? '').replace(/\/+$/, ''),
+        logLevel: (env.LOG_LEVEL ?? 'info'),
+        readonly: ['1', 'true', 'yes', 'on'].includes(String(env.READONLY ?? '').trim().toLowerCase()),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;AAkBA,gCAiBC;AAlBD,4EAA4E;AAC5E,SAAgB,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IACrD,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,SAAS;QAC3B,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QACzC,MAAM,EAAE,GAAG,CAAC,OAAO,IAAI,YAAY;QACnC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;QAClD,OAAO,EAAE,GAAG,CAAC,QAAQ;YACnB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;iBACjB,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;iBACpB,MAAM,CAAC,OAAO,CAAC;YACpB,CAAC,CAAC,SAAS;QACb,QAAQ,EAAE,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACnD,QAAQ,EAAE,CAAE,GAAG,CAAC,SAAsB,IAAI,MAAM,CAAC;QACjD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;KAC/F,CAAC;AACJ,CAAC"}

package/dist/csv.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Minimal RFC 4180-style CSV serialization and parsing, used for table and
+ * query export/import. Pure functions with no I/O so they are easy to test.
+ */
+/** Escape a single CSV field (quote when it contains comma, quote or newline). */
+export declare function csvEscape(value: unknown): string;
+/** Serialize rows to CSV with an explicit column order. */
+export declare function toCsv(rows: Record<string, unknown>[], columns: string[]): string;
+/** Serialize rows to JSON (values are expected to be already normalized). */
+export declare function toJson(rows: Record<string, unknown>[]): string;
+/**
+ * Parse CSV text into rows of string fields. Handles quoted fields containing
+ * commas, quotes and embedded newlines. Blank lines are skipped.
+ */
+export declare function parseCsv(text: string): string[][];

package/dist/csv.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Minimal RFC 4180-style CSV serialization and parsing, used for table and
+ * query export/import. Pure functions with no I/O so they are easy to test.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.csvEscape = csvEscape;
+exports.toCsv = toCsv;
+exports.toJson = toJson;
+exports.parseCsv = parseCsv;
+/** Escape a single CSV field (quote when it contains comma, quote or newline). */
+function csvEscape(value) {
+    const s = value === null || value === undefined ? '' : String(value);
+    if (/[",\r\n]/.test(s))
+        return `"${s.replace(/"/g, '""')}"`;
+    return s;
+}
+/** Serialize rows to CSV with an explicit column order. */
+function toCsv(rows, columns) {
+    const header = columns.map(csvEscape).join(',');
+    const body = rows.map((row) => columns.map((c) => csvEscape(row[c])).join(','));
+    return [header, ...body].join('\r\n');
+}
+/** Serialize rows to JSON (values are expected to be already normalized). */
+function toJson(rows) {
+    return JSON.stringify(rows, null, 2);
+}
+/**
+ * Parse CSV text into rows of string fields. Handles quoted fields containing
+ * commas, quotes and embedded newlines. Blank lines are skipped.
+ */
+function parseCsv(text) {
+    const rows = [];
+    let row = [];
+    let field = '';
+    let inQuotes = false;
+    const src = String(text ?? '');
+    for (let i = 0; i < src.length; i++) {
+        const ch = src[i];
+        if (inQuotes) {
+            if (ch === '"') {
+                if (src[i + 1] === '"') {
+                    field += '"';
+                    i++;
+                }
+                else {
+                    inQuotes = false;
+                }
+            }
+            else {
+                field += ch;
+            }
+        }
+        else if (ch === '"') {
+            inQuotes = true;
+        }
+        else if (ch === ',') {
+            row.push(field);
+            field = '';
+        }
+        else if (ch === '\n') {
+            row.push(field);
+            field = '';
+            if (row.length > 1 || row[0] !== '')
+                rows.push(row);
+            row = [];
+        }
+        else if (ch === '\r') {
+            // Ignore — part of CRLF line endings.
+        }
+        else {
+            field += ch;
+        }
+    }
+    row.push(field);
+    if (row.length > 1 || row[0] !== '')
+        rows.push(row);
+    return rows;
+}
+//# sourceMappingURL=csv.js.map

package/dist/csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../src/csv.ts"],"names":[],"mappings":"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"}

package/dist/db/database.d.ts

@@ -0,0 +1,225 @@
+import { type SQLInputValue } from 'node:sqlite';
+import type { Logger } from '../logger';
+import { type ColumnDef, type IndexDef, type TriggerDef } from '../sql/generator';
+export interface Result<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
+export interface TableListItem {
+    name: string;
+}
+export interface ColumnInfo {
+    cid: number;
+    name: string;
+    type: string;
+    notnull: number;
+    dflt_value: string | null;
+    pk: number;
+}
+export interface ForeignKeyInfo {
+    id: number;
+    seq: number;
+    table: string;
+    from: string;
+    to: string | null;
+    on_update: string;
+    on_delete: string;
+}
+export interface TableInfoData {
+    table: string;
+    columns: ColumnInfo[];
+    foreignKeys: ForeignKeyInfo[];
+    primaryKey: string[];
+}
+export interface SavedQuery {
+    id: number;
+    name: string;
+    sql: string;
+    created_at: string;
+}
+export interface WhereClause {
+    column: string;
+    value: unknown;
+}
+export interface IndexInfo {
+    name: string;
+    unique: boolean;
+    partial: number;
+    /** Index origin: 'c' = explicit CREATE INDEX, 'pk'/'u' = automatic (primary key / unique). */
+    origin: string;
+    columns: string[];
+    /** The `CREATE INDEX` statement from sqlite_master, when available. */
+    sql?: string | null;
+}
+export interface ViewInfo {
+    name: string;
+    /** The `CREATE VIEW …` statement from sqlite_master. */
+    sql: string | null;
+}
+export interface TriggerInfo {
+    name: string;
+    /** The table (or view) the trigger fires on. */
+    table: string;
+    /** The `CREATE TRIGGER …` statement from sqlite_master. */
+    sql: string | null;
+}
+export interface RowFilters {
+    [column: string]: string;
+}
+export interface ColumnDetail extends ColumnInfo {
+    unique: boolean;
+    indexed: boolean;
+    /** Foreign keys in OTHER tables whose referenced column is this column. */
+    referencedBy: {
+        table: string;
+        from: string;
+    }[];
+    /** The foreign key this column participates in (as the child), if any. */
+    fk: ForeignKeyInfo | null;
+    canDrop: boolean;
+    dropBlockers: string[];
+}
+export interface SchemaInfo {
+    table: string;
+    columns: ColumnDetail[];
+    foreignKeys: ForeignKeyInfo[];
+    indexes: IndexInfo[];
+    /** Foreign keys in other tables that reference this table. */
+    references: {
+        table: string;
+        from: string;
+        to: string;
+    }[];
+}
+export declare const INTERNAL_TABLES: {
+    readonly savedQueries: "_saved_queries";
+};
+/**
+ * Build a parameterized WHERE clause from per-column filters.
+ * Supported syntax in a filter value:
+ *   - `=value` exact match, `!=value` not-equal, `>value`, `>=value`, `<value`, `<=value`
+ *   - `value*`  prefix match
+ *   - anything else → case-insensitive substring (LIKE '%value%')
+ */
+export declare function buildFilterClause(filters: RowFilters | undefined, availableCols: string[]): {
+    where: string;
+    params: SQLInputValue[];
+};
+/**
+ * Promise-style wrapper around the standard Node `node:sqlite` driver.
+ * Every call returns a consistent `{ success, data?, error? }` shape and
+ * performs one-time, idempotent schema initialization.
+ */
+export interface DbOpenOptions {
+    /** Open the database read-only: every write is rejected. */
+    readonly?: boolean;
+}
+export declare class SqliteDatabase {
+    private db;
+    private logger;
+    readonly path: string;
+    /** True when this database was opened in read-only mode. */
+    readonly isReadOnly: boolean;
+    constructor(dbPath: string, logger: Logger, options?: DbOpenOptions);
+    /** Standard error returned for every write attempt in read-only mode. */
+    private readonlyBlocked;
+    close(): void;
+    private initSchema;
+    private tryRun;
+    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;
+    }>>;
+    /** Run a write statement, reporting row changes when it is a single statement. */
+    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;
+    }>>;
+    /** Insert many rows (used by CSV import) inside a single transaction. */
+    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;
+    }>>;
+    deleteRow(table: string, where: WhereClause[]): Promise<Result<{
+        changes: number;
+        lastInsertRowid: number | null;
+    }>>;
+    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;
+    }>>;
+    /**
+     * Detailed schema for a table: columns with constraint info, indexes,
+     * foreign keys, and which other tables reference it.
+     */
+    getSchema(table: string): Promise<Result<SchemaInfo>>;
+    renameTable(oldName: string, newName: string): Promise<Result<{
+        changes?: number;
+    }>>;
+    addColumn(table: string, col: 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;
+    }>>;
+    listViews(): Promise<Result<ViewInfo[]>>;
+    /** Preview the first `limit` rows of a view (browse). */
+    getViewRows(viewName: string, limit?: number): Promise<Result<Record<string, unknown>[]>>;
+    createView(name: string, selectSql: string): Promise<Result<{
+        changes?: number;
+    }>>;
+    dropView(name: string): Promise<Result<{
+        changes?: number;
+    }>>;
+    listTriggers(): Promise<Result<TriggerInfo[]>>;
+    createTrigger(def: TriggerDef): Promise<Result<{
+        changes?: number;
+    }>>;
+    dropTrigger(name: string): Promise<Result<{
+        changes?: number;
+    }>>;
+    private getTableInfoSync;
+}