admindb 2.1.1 → 2.3.0

package/dist/auth/types.js

@@ -1 +1,7 @@
-Object.defineProperty(exports,"__esModule",{value:!0}),exports.SESSION_COOKIE_NAME=exports.DEFAULT_SESSION_DURATION_MS=exports.DEFAULT_PASSWORD_HASH=exports.DEFAULT_USERNAME=void 0,exports.DEFAULT_USERNAME="admin",exports.DEFAULT_PASSWORD_HASH="scrypt:d9f2e64b8a1c3d5e7f0a2b4c6e801357:cb3032b16f29c8d44f75c779f070c61c846b17eb333d07596ceb8470fc1b4c06cc720c08796ebc86937dab28a3ef580ced38a71c940fd4a169fd2e9cb9fa40e2",exports.DEFAULT_SESSION_DURATION_MS=6048e5,exports.SESSION_COOKIE_NAME="admindb_session";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESSION_COOKIE_NAME = exports.DEFAULT_SESSION_DURATION_MS = exports.DEFAULT_PASSWORD_HASH = exports.DEFAULT_USERNAME = void 0;
+exports.DEFAULT_USERNAME = 'admin';
+exports.DEFAULT_PASSWORD_HASH = 'scrypt:d9f2e64b8a1c3d5e7f0a2b4c6e801357:cb3032b16f29c8d44f75c779f070c61c846b17eb333d07596ceb8470fc1b4c06cc720c08796ebc86937dab28a3ef580ced38a71c940fd4a169fd2e9cb9fa40e2';
+exports.DEFAULT_SESSION_DURATION_MS = 7 * 24 * 60 * 60 * 1000;
+exports.SESSION_COOKIE_NAME = 'admindb_session';

package/dist/cli/args.d.ts

@@ -1 +1 @@
-import type {LogLevel} from '../utils/logger';export interface CliArgs{help:boolean;version:boolean;host?:string;port?:number;dbPath?:string;connection?:string;connections?:Record<string,string>;configPath?:string;dbDir?:string;dbFiles?:string[];basePath?:string;logLevel?:LogLevel;readonly :boolean;serverless?:boolean;auth?:boolean;authUsername?:string;authPassword?:string;authSecret?:string;}export declare function helpText():string;export declare function getPackageVersion():string;export declare function versionText():string;export declare function parseArgs(argv:string[]):{args:CliArgs;error?:string;};
+import type {LogLevel} from '../utils/logger';export interface CliArgs{help:boolean;version:boolean;host?:string;port?:number;dbPath?:string;connection?:string;connections?:Record<string,string>;configPath?:string;dbDir?:string;dbFiles?:string[];basePath?:string;logLevel?:LogLevel;readonly :boolean;serverless?:boolean;auth?:boolean;authUsername?:string;authPassword?:string;authSecret?:string;}export declare function helpText():string;export declare const getPackageVersion:()=>string;export declare const versionText:()=>string;export declare function parseArgs(argv:string[]):{args:CliArgs;error?:string;};

package/dist/cli/args.js

@@ -1 +1,309 @@
-var __importDefault=this&&this.__importDefault||function(mod){return mod&&mod.__esModule?mod:{default:mod}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.helpText=function(){return["AdminDB — browser-based SQLite & PostgreSQL administration tool.","","Usage:","  admindb [options] [path|connection_url|config.json]","","Starts a local server and opens a web UI where you can browse, select and","manage SQLite databases (.db / .sqlite / .sqlite3) and PostgreSQL databases.","",'With no path or options it runs in "manager" mode: the landing page lets',"you browse the filesystem and open any database file, or create new ones.","","Arguments:","  path                           Path to a database file, PostgreSQL connection URL, or","                                 JSON configuration file containing database credentials.","","Options & Environment Variables:","  -C, --config <file.json>       Load database credentials & settings from a JSON file","  -p, --port <port>              Port to listen on (default: 45531) [PORT / ADMINDB_PORT]","  -H, --host <host>              Host/interface to bind (default: 0.0.0.0) [HOST / ADMINDB_HOST]","  -c, --connection, --pg <uri>   Open a PostgreSQL database directly [DATABASE_URL / ADMINDB_CONNECTION]","  -o, --open, --db-path <file>   Open a single database file directly [DB_PATH / ADMINDB_DB_PATH]","  -d, --dir, --db-dir <dir>      Folder of database files to manage [DB_DIR / ADMINDB_DB_DIR]","      --files, --db-files <list> Comma-separated database file paths [DB_FILES / ADMINDB_DB_FILES]","  -b, --base-path, --base <p>    URL prefix to serve under (default: /) [BASE_PATH / ADMINDB_BASE_PATH]","  -r, --readonly, --read-only    Open databases read-only (writes disabled) [READONLY / ADMINDB_READONLY]","      --serverless               Enable serverless mode (enforces read-only, disables writes) [SERVERLESS / ADMINDB_SERVERLESS]","      --auth                     Enable authentication (default: on) [ADMINDB_AUTH=true]","      --no-auth, --disable-auth  Disable authentication completely [ADMINDB_NO_AUTH=1 / ADMINDB_AUTH=false]","  -u, --username, --user <user>  Admin username (default: admin) [ADMINDB_USERNAME / ADMINDB_USER]","  -P, --password, --pass <pass>  Admin password or hash [ADMINDB_PASSWORD / ADMINDB_PASS]","      --auth-secret <sec>        Secret key used to sign session cookies [ADMINDB_SECRET / SESSION_SECRET]","  -l, --log-level <level>        debug | info | warn | error (default: info) [LOG_LEVEL / ADMINDB_LOG_LEVEL]","  -h, --help                     Show this help message","  -v, --version                  Show version","","Examples:","  admindb name.postgres.json                   # load database connections from a JSON file","  admindb postgresql://user:pass@host:5432/db  # open a PostgreSQL database directly","  admindb ./data/app.db                        # open a SQLite database file","  admindb --no-auth                            # run with authentication turned off","  admindb -C ./connections.json                # run with JSON connections config","","See docs/EXAMPLES.md for full configuration reference and deployment recipes."].join("\n")},exports.getPackageVersion=function(){return packageVersion()},exports.versionText=function(){const v=packageVersion();return v?`admindb v${v}`:"admindb"},exports.parseArgs=function(argv){const args={help:!1,version:!1,readonly:!1},positional=[];let i=0;const invalid=error=>({args:args,error:error}),takeValue=flag=>{const eq=argv[i].indexOf("=");return-1!==eq?argv[i].slice(eq+1):(i+=1,argv[i])};for(;i<argv.length;){const tok=argv[i];if("-h"===tok||"--help"===tok)args.help=!0;else if("-v"===tok||"--version"===tok)args.version=!0;else if(isFlag(tok,"-C","--config","--json")){const v=takeValue();if(void 0===v)return invalid("Missing value for --config.");args.configPath=v;try{const fileConf=(0,config_1.parseConfigFile)(v);fileConf&&(fileConf.connections&&(args.connections=fileConf.connections),fileConf.connection&&(args.connection=fileConf.connection),void 0!==fileConf.port&&(args.port=fileConf.port),void 0!==fileConf.host&&(args.host=fileConf.host),void 0!==fileConf.basePath&&(args.basePath=fileConf.basePath),void 0!==fileConf.readonly&&(args.readonly=fileConf.readonly),void 0!==fileConf.serverless&&(args.serverless=fileConf.serverless),void 0!==fileConf.logLevel&&(args.logLevel=fileConf.logLevel),"boolean"==typeof fileConf.auth?args.auth=fileConf.auth:fileConf.auth&&"object"==typeof fileConf.auth&&(args.auth=!0,fileConf.auth.username&&(args.authUsername=fileConf.auth.username),fileConf.auth.password&&(args.authPassword=fileConf.auth.password),fileConf.auth.secret&&(args.authSecret=fileConf.auth.secret)))}catch(err){return invalid(err.message)}}else if(isFlag(tok,"-p","--port")){const v=takeValue();if(void 0===v)return invalid("Missing value for --port.");const n=Number.parseInt(v,10);if(!Number.isFinite(n)||n<=0)return invalid(`Invalid port: "${v}".`);args.port=n}else if(isFlag(tok,"-H","--host")){const v=takeValue();if(void 0===v)return invalid("Missing value for --host.");args.host=v}else if(isFlag(tok,"-c","--connection","--conn","--pg")){const v=takeValue();if(void 0===v)return invalid("Missing value for --connection.");args.connection=v,args.dbPath=v}else if(isFlag(tok,"-o","--open","--db","-f","--file","--db-path","--path")){const v=takeValue();if(void 0===v)return invalid("Missing value for --open / --db-path.");args.dbPath=v,(v.startsWith("postgres://")||v.startsWith("postgresql://"))&&(args.connection=v)}else if(isFlag(tok,"-d","--dir","--folder","--db-dir")){const v=takeValue();if(void 0===v)return invalid("Missing value for --dir / --db-dir.");args.dbDir=v}else if(isFlag(tok,"--files","--db-files")){const v=takeValue();if(void 0===v)return invalid("Missing value for --files / --db-files.");args.dbFiles=v.split(",").map(s=>s.trim()).filter(Boolean)}else if(isFlag(tok,"-b","--base-path","--base")){const v=takeValue();if(void 0===v)return invalid("Missing value for --base-path.");args.basePath=v}else if(isFlag(tok,"-l","--log-level")){const v=takeValue();if(void 0===v)return invalid("Missing value for --log-level.");if(!LOG_LEVELS.includes(v))return invalid(`Invalid log level: "${v}". Expected one of: ${LOG_LEVELS.join(", ")}.`);args.logLevel=v}else if("-r"===tok||"--readonly"===tok||"--read-only"===tok)args.readonly=!0;else if("--serverless"===tok)args.serverless=!0,args.readonly=!0;else if("--no-auth"===tok||"--disable-auth"===tok)args.auth=!1;else if("--auth"===tok)args.auth=!0;else if(isFlag(tok,"-u","--username","--user","--auth-username")){const v=takeValue();if(void 0===v)return invalid("Missing value for --username.");args.authUsername=v}else if(isFlag(tok,"-P","--password","--pass","--auth-password")){const v=takeValue();if(void 0===v)return invalid("Missing value for --password.");args.authPassword=v}else if(isFlag(tok,"--auth-secret","--secret","--session-secret")){const v=takeValue();if(void 0===v)return invalid("Missing value for --auth-secret.");args.authSecret=v}else{if(tok.startsWith("-")&&tok.length>1)return invalid(`Unknown option: "${tok}".`);positional.push(tok)}i+=1}if(positional.length>1)return invalid(`Unexpected extra arguments: ${positional.slice(1).join(" ")}.`);const p=positional[0];if(p)if(p.startsWith("postgres://")||p.startsWith("postgresql://"))args.connection=p,args.dbPath=p;else if(p.endsWith(".json")||(0,node_fs_1.existsSync)(p))try{if(p.endsWith(".json")||(0,node_fs_1.statSync)(p).isFile()&&p.includes(".json")){args.configPath=p;const fileConf=(0,config_1.parseConfigFile)(p);fileConf&&(fileConf.connections&&(args.connections=fileConf.connections),fileConf.connection&&(args.connection=fileConf.connection),void 0!==fileConf.port&&void 0===args.port&&(args.port=fileConf.port),void 0!==fileConf.host&&void 0===args.host&&(args.host=fileConf.host),void 0!==fileConf.basePath&&void 0===args.basePath&&(args.basePath=fileConf.basePath),void 0!==fileConf.readonly&&(args.readonly=fileConf.readonly),void 0!==fileConf.serverless&&(args.serverless=fileConf.serverless),void 0!==fileConf.logLevel&&void 0===args.logLevel&&(args.logLevel=fileConf.logLevel),void 0===args.auth&&("boolean"==typeof fileConf.auth?args.auth=fileConf.auth:fileConf.auth&&"object"==typeof fileConf.auth&&(args.auth=!0,fileConf.auth.username&&!args.authUsername&&(args.authUsername=fileConf.auth.username),fileConf.auth.password&&!args.authPassword&&(args.authPassword=fileConf.auth.password),fileConf.auth.secret&&!args.authSecret&&(args.authSecret=fileConf.auth.secret))))}else(0,node_fs_1.statSync)(p).isDirectory()?args.dbDir=p:args.dbPath=p}catch(err){if(p.endsWith(".json"))return invalid(err.message);args.dbPath=p}else args.dbPath=p;return{args:args}};const node_fs_1=require("node:fs"),node_path_1=__importDefault(require("node:path")),config_1=require("./config"),LOG_LEVELS=["debug","info","warn","error"];function packageVersion(){try{const candidates=[node_path_1.default.join(__dirname,"..","..","package.json"),node_path_1.default.join(__dirname,"..","package.json"),node_path_1.default.join(__dirname,"package.json")];for(const p of candidates)if((0,node_fs_1.existsSync)(p)){const raw=(0,node_fs_1.readFileSync)(p,"utf8"),pkg=JSON.parse(raw);if(pkg.version)return pkg.version}return""}catch{return""}}function isFlag(tok,...names){return names.includes(tok)||names.some(n=>n.length>2&&tok.startsWith(n+"="))}
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.versionText = exports.getPackageVersion = void 0;
+exports.helpText = helpText;
+exports.parseArgs = parseArgs;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const common_1 = require("../utils/common");
+const config_1 = require("./config");
+const LOG_LEVELS = ['debug', 'info', 'warn', 'error'];
+function helpText() {
+    return [
+        'AdminDB — browser-based SQLite & PostgreSQL administration tool.',
+        '',
+        'Usage:',
+        '  admindb [options] [path|connection_url|config.json]',
+        '',
+        'Starts a local server and opens a web UI where you can browse, select and',
+        'manage SQLite databases (.db / .sqlite / .sqlite3) and PostgreSQL databases.',
+        '',
+        'With no path or options it runs in "manager" mode: the landing page lets',
+        'you browse the filesystem and open any database file, or create new ones.',
+        '',
+        'Arguments:',
+        '  path                           Path to a database file, PostgreSQL connection URL, or',
+        '                                 JSON configuration file containing database credentials.',
+        '',
+        'Options & Environment Variables:',
+        '  -C, --config <file.json>       Load database credentials & settings from a JSON file',
+        '  -p, --port <port>              Port to listen on (default: 45531) [PORT / ADMINDB_PORT]',
+        '  -H, --host <host>              Host/interface to bind (default: 0.0.0.0) [HOST / ADMINDB_HOST]',
+        '  -c, --connection, --pg <uri>   Open a PostgreSQL database directly [DATABASE_URL / ADMINDB_CONNECTION]',
+        '  -o, --open, --db-path <file>   Open a single database file directly [DB_PATH / ADMINDB_DB_PATH]',
+        '  -d, --dir, --db-dir <dir>      Folder of database files to manage [DB_DIR / ADMINDB_DB_DIR]',
+        '      --files, --db-files <list> Comma-separated database file paths [DB_FILES / ADMINDB_DB_FILES]',
+        '  -b, --base-path, --base <p>    URL prefix to serve under (default: /) [BASE_PATH / ADMINDB_BASE_PATH]',
+        '  -r, --readonly, --read-only    Open databases read-only (writes disabled) [READONLY / ADMINDB_READONLY]',
+        '      --serverless               Enable serverless mode (enforces read-only, disables writes) [SERVERLESS / ADMINDB_SERVERLESS]',
+        '      --auth                     Enable authentication (default: on) [ADMINDB_AUTH=true]',
+        '      --no-auth, --disable-auth  Disable authentication completely [ADMINDB_NO_AUTH=1 / ADMINDB_AUTH=false]',
+        '  -u, --username, --user <user>  Admin username (default: admin) [ADMINDB_USERNAME / ADMINDB_USER]',
+        '  -P, --password, --pass <pass>  Admin password or hash [ADMINDB_PASSWORD / ADMINDB_PASS]',
+        '      --auth-secret <sec>        Secret key used to sign session cookies [ADMINDB_SECRET / SESSION_SECRET]',
+        '  -l, --log-level <level>        debug | info | warn | error (default: info) [LOG_LEVEL / ADMINDB_LOG_LEVEL]',
+        '  -h, --help                     Show this help message',
+        '  -v, --version                  Show version',
+        '',
+        'Examples:',
+        '  admindb name.postgres.json                   # load database connections from a JSON file',
+        '  admindb postgresql://user:pass@host:5432/db  # open a PostgreSQL database directly',
+        '  admindb ./data/app.db                        # open a SQLite database file',
+        '  admindb --no-auth                            # run with authentication turned off',
+        '  admindb -C ./connections.json                # run with JSON connections config',
+        '',
+        'See docs/EXAMPLES.md for full configuration reference and deployment recipes.',
+    ].join('\n');
+}
+function packageVersion() {
+    try {
+        const candidates = [
+            node_path_1.default.join(__dirname, '..', '..', 'package.json'),
+            node_path_1.default.join(__dirname, '..', 'package.json'),
+            node_path_1.default.join(__dirname, 'package.json'),
+        ];
+        for (const p of candidates) {
+            if ((0, node_fs_1.existsSync)(p)) {
+                const pkg = JSON.parse((0, node_fs_1.readFileSync)(p, 'utf8'));
+                if (pkg.version)
+                    return pkg.version;
+            }
+        }
+    }
+    catch { }
+    return '';
+}
+const getPackageVersion = () => packageVersion();
+exports.getPackageVersion = getPackageVersion;
+const versionText = () => {
+    const v = packageVersion();
+    return v ? `admindb v${v}` : 'admindb';
+};
+exports.versionText = versionText;
+const isFlag = (tok, ...names) => names.includes(tok) || names.some((n) => n.length > 2 && tok.startsWith(`${n}=`));
+function parseArgs(argv) {
+    const args = { help: false, version: false, readonly: false };
+    const positional = [];
+    let i = 0;
+    const invalid = (error) => ({ args, error });
+    const takeValue = (flag) => {
+        const eq = argv[i].indexOf('=');
+        if (eq !== -1)
+            return argv[i].slice(eq + 1);
+        i++;
+        return argv[i];
+    };
+    while (i < argv.length) {
+        const tok = argv[i];
+        if (tok === '-h' || tok === '--help') {
+            args.help = true;
+        }
+        else if (tok === '-v' || tok === '--version') {
+            args.version = true;
+        }
+        else if (isFlag(tok, '-C', '--config', '--json')) {
+            const v = takeValue('--config');
+            if (v === undefined)
+                return invalid('Missing value for --config.');
+            args.configPath = v;
+            try {
+                const fileConf = (0, config_1.parseConfigFile)(v);
+                if (fileConf) {
+                    if (fileConf.connections)
+                        args.connections = fileConf.connections;
+                    if (fileConf.connection)
+                        args.connection = fileConf.connection;
+                    if (fileConf.port !== undefined)
+                        args.port = fileConf.port;
+                    if (fileConf.host !== undefined)
+                        args.host = fileConf.host;
+                    if (fileConf.basePath !== undefined)
+                        args.basePath = fileConf.basePath;
+                    if (fileConf.readonly !== undefined)
+                        args.readonly = fileConf.readonly;
+                    if (fileConf.serverless !== undefined)
+                        args.serverless = fileConf.serverless;
+                    if (fileConf.logLevel !== undefined)
+                        args.logLevel = fileConf.logLevel;
+                    if (typeof fileConf.auth === 'boolean')
+                        args.auth = fileConf.auth;
+                    else if (fileConf.auth && typeof fileConf.auth === 'object') {
+                        args.auth = true;
+                        if (fileConf.auth.username)
+                            args.authUsername = fileConf.auth.username;
+                        if (fileConf.auth.password)
+                            args.authPassword = fileConf.auth.password;
+                        if (fileConf.auth.secret)
+                            args.authSecret = fileConf.auth.secret;
+                    }
+                }
+            }
+            catch (err) {
+                return invalid(err.message);
+            }
+        }
+        else if (isFlag(tok, '-p', '--port')) {
+            const v = takeValue('--port');
+            if (v === undefined)
+                return invalid('Missing value for --port.');
+            const n = Number.parseInt(v, 10);
+            if (!Number.isFinite(n) || n <= 0)
+                return invalid(`Invalid port: "${v}".`);
+            args.port = n;
+        }
+        else if (isFlag(tok, '-H', '--host')) {
+            const v = takeValue('--host');
+            if (v === undefined)
+                return invalid('Missing value for --host.');
+            args.host = v;
+        }
+        else if (isFlag(tok, '-c', '--connection', '--conn', '--pg')) {
+            const v = takeValue('--connection');
+            if (v === undefined)
+                return invalid('Missing value for --connection.');
+            args.connection = v;
+            args.dbPath = v;
+        }
+        else if (isFlag(tok, '-o', '--open', '--db', '-f', '--file', '--db-path', '--path')) {
+            const v = takeValue('--open');
+            if (v === undefined)
+                return invalid('Missing value for --open / --db-path.');
+            args.dbPath = v;
+            if ((0, common_1.isPostgresConnectionString)(v))
+                args.connection = v;
+        }
+        else if (isFlag(tok, '-d', '--dir', '--folder', '--db-dir')) {
+            const v = takeValue('--dir');
+            if (v === undefined)
+                return invalid('Missing value for --dir / --db-dir.');
+            args.dbDir = v;
+        }
+        else if (isFlag(tok, '--files', '--db-files')) {
+            const v = takeValue('--files');
+            if (v === undefined)
+                return invalid('Missing value for --files / --db-files.');
+            args.dbFiles = v.split(',').map((s) => s.trim()).filter(Boolean);
+        }
+        else if (isFlag(tok, '-b', '--base-path', '--base')) {
+            const v = takeValue('--base-path');
+            if (v === undefined)
+                return invalid('Missing value for --base-path.');
+            args.basePath = v;
+        }
+        else if (isFlag(tok, '-l', '--log-level')) {
+            const v = takeValue('--log-level');
+            if (v === undefined)
+                return invalid('Missing value for --log-level.');
+            if (!LOG_LEVELS.includes(v)) {
+                return invalid(`Invalid log level: "${v}". Expected one of: ${LOG_LEVELS.join(', ')}.`);
+            }
+            args.logLevel = v;
+        }
+        else if (tok === '-r' || tok === '--readonly' || tok === '--read-only') {
+            args.readonly = true;
+        }
+        else if (tok === '--serverless') {
+            args.serverless = true;
+            args.readonly = true;
+        }
+        else if (tok === '--no-auth' || tok === '--disable-auth') {
+            args.auth = false;
+        }
+        else if (tok === '--auth') {
+            args.auth = true;
+        }
+        else if (isFlag(tok, '-u', '--username', '--user', '--auth-username')) {
+            const v = takeValue('--username');
+            if (v === undefined)
+                return invalid('Missing value for --username.');
+            args.authUsername = v;
+        }
+        else if (isFlag(tok, '-P', '--password', '--pass', '--auth-password')) {
+            const v = takeValue('--password');
+            if (v === undefined)
+                return invalid('Missing value for --password.');
+            args.authPassword = v;
+        }
+        else if (isFlag(tok, '--auth-secret', '--secret', '--session-secret')) {
+            const v = takeValue('--auth-secret');
+            if (v === undefined)
+                return invalid('Missing value for --auth-secret.');
+            args.authSecret = v;
+        }
+        else if (tok.startsWith('-') && tok.length > 1) {
+            return invalid(`Unknown option: "${tok}".`);
+        }
+        else {
+            positional.push(tok);
+        }
+        i++;
+    }
+    if (positional.length > 1) {
+        return invalid(`Unexpected extra arguments: ${positional.slice(1).join(' ')}.`);
+    }
+    const p = positional[0];
+    if (p) {
+        if ((0, common_1.isPostgresConnectionString)(p)) {
+            args.connection = p;
+            args.dbPath = p;
+        }
+        else if (p.endsWith('.json') || (0, node_fs_1.existsSync)(p)) {
+            try {
+                const isJson = p.endsWith('.json');
+                if (isJson || ((0, node_fs_1.statSync)(p).isFile() && p.includes('.json'))) {
+                    args.configPath = p;
+                    const fileConf = (0, config_1.parseConfigFile)(p);
+                    if (fileConf) {
+                        if (fileConf.connections)
+                            args.connections = fileConf.connections;
+                        if (fileConf.connection)
+                            args.connection = fileConf.connection;
+                        if (fileConf.port !== undefined && args.port === undefined)
+                            args.port = fileConf.port;
+                        if (fileConf.host !== undefined && args.host === undefined)
+                            args.host = fileConf.host;
+                        if (fileConf.basePath !== undefined && args.basePath === undefined)
+                            args.basePath = fileConf.basePath;
+                        if (fileConf.readonly !== undefined)
+                            args.readonly = fileConf.readonly;
+                        if (fileConf.serverless !== undefined)
+                            args.serverless = fileConf.serverless;
+                        if (fileConf.logLevel !== undefined && args.logLevel === undefined)
+                            args.logLevel = fileConf.logLevel;
+                        if (args.auth === undefined) {
+                            if (typeof fileConf.auth === 'boolean')
+                                args.auth = fileConf.auth;
+                            else if (fileConf.auth && typeof fileConf.auth === 'object') {
+                                args.auth = true;
+                                if (fileConf.auth.username && !args.authUsername)
+                                    args.authUsername = fileConf.auth.username;
+                                if (fileConf.auth.password && !args.authPassword)
+                                    args.authPassword = fileConf.auth.password;
+                                if (fileConf.auth.secret && !args.authSecret)
+                                    args.authSecret = fileConf.auth.secret;
+                            }
+                        }
+                    }
+                }
+                else if ((0, node_fs_1.statSync)(p).isDirectory()) {
+                    args.dbDir = p;
+                }
+                else {
+                    args.dbPath = p;
+                }
+            }
+            catch (err) {
+                if (p.endsWith('.json'))
+                    return invalid(err.message);
+                args.dbPath = p;
+            }
+        }
+        else {
+            args.dbPath = p;
+        }
+    }
+    return { args };
+}

package/dist/cli/config.js

@@ -1 +1,118 @@
-var __importDefault=this&&this.__importDefault||function(mod){return mod&&mod.__esModule?mod:{default:mod}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.parseConfigFile=parseConfigFile,exports.loadConfig=function(env=process.env){const portRaw=env.ADMINDB_PORT??env.PORT??"45531",port=Number.parseInt(portRaw,10),authDisabled=["0","false","no","off"].includes(String(env.ADMINDB_AUTH??"").trim().toLowerCase())||["1","true","yes"].includes(String(env.ADMINDB_NO_AUTH??env.ADMINDB_DISABLE_AUTH??"").trim().toLowerCase()),dbDirRaw=env.ADMINDB_DB_DIR??env.ADMINDB_DIR??env.DB_DIR,dbFilesRaw=env.ADMINDB_DB_FILES??env.DB_FILES,connectionRaw=env.ADMINDB_CONNECTION??env.DATABASE_URL??env.PG_CONNECTION??env.POSTGRES_URL,dbPathRaw=env.ADMINDB_DB_PATH??env.ADMINDB_PATH??env.DB_PATH??connectionRaw,basePathRaw=env.ADMINDB_BASE_PATH??env.BASE_PATH??"",logLevelRaw=env.ADMINDB_LOG_LEVEL??env.LOG_LEVEL??"info",serverlessRaw=env.ADMINDB_SERVERLESS??env.SERVERLESS??env.IS_SERVERLESS??"",serverless=["1","true","yes","on"].includes(String(serverlessRaw).trim().toLowerCase())||(0,serverless_1.isServerlessEnvironment)(env),readonlyRaw=env.ADMINDB_READONLY??env.READONLY??"",readonly=serverless||["1","true","yes","on"].includes(String(readonlyRaw).trim().toLowerCase());let connections;const configJsonRaw=env.ADMINDB_CONFIG_JSON??env.ADMINDB_CONNECTIONS;if(configJsonRaw)try{const parsed=JSON.parse(configJsonRaw);parsed&&"object"==typeof parsed&&!Array.isArray(parsed)&&(connections=parsed)}catch{}const configPath=env.ADMINDB_CONFIG;if(configPath&&(0,node_fs_1.existsSync)(configPath)){const fileConf=parseConfigFile(configPath);fileConf?.connections&&(connections={...connections??{},...fileConf.connections})}return{host:env.ADMINDB_HOST??env.HOST??"0.0.0.0",port:Number.isFinite(port)?port:45531,dbPath:dbPathRaw?String(dbPathRaw):"admindb.db",connection:connectionRaw?String(connectionRaw):void 0,connections:connections,dbDir:dbDirRaw?String(dbDirRaw):void 0,dbFiles:dbFilesRaw?String(dbFilesRaw).split(",").map(s=>s.trim()).filter(Boolean):void 0,basePath:String(basePathRaw).replace(/\/+$/,""),logLevel:logLevelRaw,readonly:readonly,serverless:serverless,auth:!authDisabled,authUsername:env.ADMINDB_USERNAME??env.ADMINDB_USER?String(env.ADMINDB_USERNAME??env.ADMINDB_USER).trim():void 0,authPassword:env.ADMINDB_PASSWORD??env.ADMINDB_PASS?String(env.ADMINDB_PASSWORD??env.ADMINDB_PASS).trim():void 0,authSecret:env.ADMINDB_SECRET??env.SESSION_SECRET?String(env.ADMINDB_SECRET??env.SESSION_SECRET).trim():void 0}};const node_fs_1=require("node:fs"),node_path_1=__importDefault(require("node:path")),serverless_1=require("../serverless"),common_1=require("../utils/common");function parseConfigFile(filePath){try{const absPath=node_path_1.default.resolve(filePath);if(!(0,node_fs_1.existsSync)(absPath))return null;const content=(0,node_fs_1.readFileSync)(absPath,"utf8"),parsed=JSON.parse(content);if(!parsed||"object"!=typeof parsed||Array.isArray(parsed))return null;const result={},conns={},topDbs=parsed.databases||parsed.connections;if(topDbs&&"object"==typeof topDbs&&!Array.isArray(topDbs))for(const[k,v]of Object.entries(topDbs))"string"==typeof v&&v.trim()?conns[k.trim()]=v.trim():v&&"object"==typeof v&&"string"==typeof v.connection&&(conns[k.trim()]=v.connection.trim());for(const[k,v]of Object.entries(parsed))["databases","connections","port","host","basePath","readonly","serverless","auth","logLevel","username","password","secret"].includes(k)||("string"==typeof v&&v.trim()?conns[k.trim()]=v.trim():v&&"object"==typeof v&&"string"==typeof v.connection&&(conns[k.trim()]=v.connection.trim()));return"string"==typeof parsed.connection&&parsed.connection.trim()&&(result.connection=parsed.connection.trim()),"number"==typeof parsed.port&&(result.port=parsed.port),"string"==typeof parsed.host&&(result.host=parsed.host),"string"==typeof parsed.basePath&&(result.basePath=parsed.basePath),"boolean"==typeof parsed.readonly&&(result.readonly=parsed.readonly),"boolean"==typeof parsed.serverless&&(result.serverless=parsed.serverless),("boolean"==typeof parsed.auth||parsed.auth&&"object"==typeof parsed.auth)&&(result.auth=parsed.auth),"string"==typeof parsed.logLevel&&(result.logLevel=parsed.logLevel),Object.keys(conns).length>0&&(result.connections=conns),result}catch(err){throw new Error(`Failed to parse configuration file "${filePath}": ${(0,common_1.errorMessage)(err)}`)}}
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseConfigFile = parseConfigFile;
+exports.loadConfig = loadConfig;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const serverless_1 = require("../serverless");
+const common_1 = require("../utils/common");
+function parseConfigFile(filePath) {
+    try {
+        const absPath = node_path_1.default.resolve(filePath);
+        if (!(0, node_fs_1.existsSync)(absPath))
+            return null;
+        const content = (0, node_fs_1.readFileSync)(absPath, 'utf8');
+        const parsed = JSON.parse(content);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            return null;
+        const result = {};
+        const conns = {};
+        const topDbs = parsed.databases || parsed.connections;
+        if (topDbs && typeof topDbs === 'object' && !Array.isArray(topDbs)) {
+            for (const [k, v] of Object.entries(topDbs)) {
+                if (typeof v === 'string' && v.trim())
+                    conns[k.trim()] = v.trim();
+                else if (v && typeof v === 'object' && typeof v.connection === 'string') {
+                    conns[k.trim()] = v.connection.trim();
+                }
+            }
+        }
+        for (const [k, v] of Object.entries(parsed)) {
+            if (['databases', 'connections', 'port', 'host', 'basePath', 'readonly', 'serverless', 'auth', 'logLevel', 'username', 'password', 'secret'].includes(k)) {
+                continue;
+            }
+            if (typeof v === 'string' && v.trim()) {
+                conns[k.trim()] = v.trim();
+            }
+            else if (v && typeof v === 'object' && typeof v.connection === 'string') {
+                conns[k.trim()] = v.connection.trim();
+            }
+        }
+        if (typeof parsed.connection === 'string' && parsed.connection.trim())
+            result.connection = parsed.connection.trim();
+        if (typeof parsed.port === 'number')
+            result.port = parsed.port;
+        if (typeof parsed.host === 'string')
+            result.host = parsed.host;
+        if (typeof parsed.basePath === 'string')
+            result.basePath = parsed.basePath;
+        if (typeof parsed.readonly === 'boolean')
+            result.readonly = parsed.readonly;
+        if (typeof parsed.serverless === 'boolean')
+            result.serverless = parsed.serverless;
+        if (typeof parsed.auth === 'boolean' || (parsed.auth && typeof parsed.auth === 'object'))
+            result.auth = parsed.auth;
+        if (typeof parsed.logLevel === 'string')
+            result.logLevel = parsed.logLevel;
+        if (Object.keys(conns).length > 0)
+            result.connections = conns;
+        return result;
+    }
+    catch (err) {
+        throw new Error(`Failed to parse configuration file "${filePath}": ${(0, common_1.errorMessage)(err)}`);
+    }
+}
+function loadConfig(env = process.env) {
+    const portRaw = env.ADMINDB_PORT ?? env.PORT ?? '45531';
+    const port = Number.parseInt(portRaw, 10);
+    const authDisabled = ['0', 'false', 'no', 'off'].includes(String(env.ADMINDB_AUTH ?? '').trim().toLowerCase()) ||
+        ['1', 'true', 'yes'].includes(String(env.ADMINDB_NO_AUTH ?? env.ADMINDB_DISABLE_AUTH ?? '').trim().toLowerCase());
+    const dbDirRaw = env.ADMINDB_DB_DIR ?? env.ADMINDB_DIR ?? env.DB_DIR;
+    const dbFilesRaw = env.ADMINDB_DB_FILES ?? env.DB_FILES;
+    const connectionRaw = env.ADMINDB_CONNECTION ?? env.DATABASE_URL ?? env.PG_CONNECTION ?? env.POSTGRES_URL;
+    const dbPathRaw = env.ADMINDB_DB_PATH ?? env.ADMINDB_PATH ?? env.DB_PATH ?? connectionRaw;
+    const basePathRaw = env.ADMINDB_BASE_PATH ?? env.BASE_PATH ?? '';
+    const logLevelRaw = env.ADMINDB_LOG_LEVEL ?? env.LOG_LEVEL ?? 'info';
+    const serverlessRaw = env.ADMINDB_SERVERLESS ?? env.SERVERLESS ?? env.IS_SERVERLESS ?? '';
+    const serverless = ['1', 'true', 'yes', 'on'].includes(String(serverlessRaw).trim().toLowerCase()) ||
+        (0, serverless_1.isServerlessEnvironment)(env);
+    const readonlyRaw = env.ADMINDB_READONLY ?? env.READONLY ?? '';
+    const readonly = serverless || ['1', 'true', 'yes', 'on'].includes(String(readonlyRaw).trim().toLowerCase());
+    let connections;
+    const configJsonRaw = env.ADMINDB_CONFIG_JSON ?? env.ADMINDB_CONNECTIONS;
+    if (configJsonRaw) {
+        try {
+            const parsed = JSON.parse(configJsonRaw);
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed))
+                connections = parsed;
+        }
+        catch { }
+    }
+    const configPath = env.ADMINDB_CONFIG;
+    if (configPath && (0, node_fs_1.existsSync)(configPath)) {
+        const fileConf = parseConfigFile(configPath);
+        if (fileConf?.connections) {
+            connections = { ...(connections ?? {}), ...fileConf.connections };
+        }
+    }
+    return {
+        host: env.ADMINDB_HOST ?? env.HOST ?? '0.0.0.0',
+        port: Number.isFinite(port) ? port : 45531,
+        dbPath: dbPathRaw ? String(dbPathRaw) : 'admindb.db',
+        connection: connectionRaw ? String(connectionRaw) : undefined,
+        connections,
+        dbDir: dbDirRaw ? String(dbDirRaw) : undefined,
+        dbFiles: dbFilesRaw ? String(dbFilesRaw).split(',').map((s) => s.trim()).filter(Boolean) : undefined,
+        basePath: String(basePathRaw).replace(/\/+$/, ''),
+        logLevel: logLevelRaw,
+        readonly,
+        serverless,
+        auth: !authDisabled,
+        authUsername: (env.ADMINDB_USERNAME ?? env.ADMINDB_USER) ? String(env.ADMINDB_USERNAME ?? env.ADMINDB_USER).trim() : undefined,
+        authPassword: (env.ADMINDB_PASSWORD ?? env.ADMINDB_PASS) ? String(env.ADMINDB_PASSWORD ?? env.ADMINDB_PASS).trim() : undefined,
+        authSecret: (env.ADMINDB_SECRET ?? env.SESSION_SECRET) ? String(env.ADMINDB_SECRET ?? env.SESSION_SECRET).trim() : undefined,
+    };
+}

package/dist/cli/index.js

@@ -1 +1,20 @@
-var __createBinding=this&&this.__createBinding||(Object.create?function(o,m,k,k2){void 0===k2&&(k2=k);var desc=Object.getOwnPropertyDescriptor(m,k);desc&&!("get"in desc?!m.__esModule:desc.writable||desc.configurable)||(desc={enumerable:!0,get:function(){return m[k]}}),Object.defineProperty(o,k2,desc)}:function(o,m,k,k2){void 0===k2&&(k2=k),o[k2]=m[k]}),__exportStar=this&&this.__exportStar||function(m,exports){for(var p in m)"default"===p||Object.prototype.hasOwnProperty.call(exports,p)||__createBinding(exports,m,p)};Object.defineProperty(exports,"__esModule",{value:!0}),__exportStar(require("./args"),exports),__exportStar(require("../utils/colors"),exports),__exportStar(require("./config"),exports),__exportStar(require("./runner"),exports);
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./args"), exports);
+__exportStar(require("../utils/colors"), exports);
+__exportStar(require("./config"), exports);
+__exportStar(require("./runner"), exports);