admindb 2.1.1 → 2.2.1

package/dist/cli/config.js

@@ -1 +1,128 @@
-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);

package/dist/cli/runner.js

@@ -1 +1,211 @@
-var __importDefault=this&&this.__importDefault||function(mod){return mod&&mod.__esModule?mod:{default:mod}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.runCli=function(){const env=(0,config_1.loadConfig)(),parsed=(0,args_1.parseArgs)(process.argv.slice(2));parsed.error&&(console.error(colors_1.c.red(colors_1.c.bold(`Error: ${parsed.error}`))),console.error(),console.error((0,args_1.helpText)()),process.exit(1));const args=parsed.args;args.help&&(console.log((0,args_1.helpText)()),process.exit(0));args.version&&(console.log((0,args_1.versionText)()),process.exit(0));const authEnabled=void 0!==args.auth?args.auth:env.auth,authUsername=args.authUsername??env.authUsername??"admin",authPassword=args.authPassword??env.authPassword,authSecret=args.authSecret??env.authSecret,serverless=void 0!==args.serverless?args.serverless:env.serverless,readonly=serverless||args.readonly||env.readonly,connections=args.connections??env.connections,hasConnections=Boolean(connections&&Object.keys(connections).length>0),config={host:args.host??env.host,port:args.port??env.port,dbPath:args.dbPath??env.dbPath,connection:args.connection??env.connection,connections:connections,dbDir:args.dbDir??env.dbDir,dbFiles:args.dbFiles??env.dbFiles,basePath:(args.basePath??env.basePath).replace(/\/+$/,""),logLevel:args.logLevel??env.logLevel,readonly:readonly,serverless:serverless,auth:!!authEnabled&&{enabled:!0,username:authUsername,password:authPassword,secret:authSecret}},logger=(0,logger_1.createLogger)(config.logLevel,"admindb"),app=(0,express_1.default)();app.disable("x-powered-by");const hasDir=Boolean(config.dbDir),hasFiles=Boolean(config.dbFiles&&config.dbFiles.length>0),explicitFile=args.connection??config.connection??args.dbPath??(process.env.ADMINDB_DB_PATH||process.env.ADMINDB_PATH||process.env.DB_PATH?config.dbPath:void 0),isPg=Boolean(explicitFile&&(explicitFile.startsWith("postgres://")||explicitFile.startsWith("postgresql://"))),useManager=!(!hasConnections&&(Boolean(explicitFile)||isPg)&&!hasDir&&!hasFiles),managerFiles=[...config.dbFiles??[]];useManager&&explicitFile&&!hasConnections&&managerFiles.push(explicitFile);const managerDir=hasDir?config.dbDir:hasFiles||explicitFile||hasConnections?void 0:process.cwd(),allowBrowse=useManager&&(hasDir||!hasFiles&&!explicitFile&&!hasConnections),browseRoot=hasDir?node_path_1.default.resolve(config.dbDir):void 0,router=useManager?(0,app_1.createRouter)({manager:new manager_1.DbManager({dir:managerDir,files:managerFiles,connections:connections,readonly:config.readonly},logger),basePath:config.basePath,logger:logger,readonly:config.readonly,serverless:config.serverless,allowBrowse:allowBrowse,browseRoot:browseRoot,auth:config.auth}):(0,app_1.createRouter)({dbPath:explicitFile,connection:explicitFile,basePath:config.basePath,logger:logger,readonly:config.readonly,serverless:config.serverless,auth:config.auth});app.use(config.basePath||"/",router);const server=app.listen(config.port,config.host,()=>{const v=(0,args_1.getPackageVersion)(),versionStr=v?` v${v}`:"",isAnyHost="0.0.0.0"===config.host||"::"===config.host||""===config.host,localUrl=`http://${isAnyHost?"localhost":config.host}:${config.port}${config.basePath}/`;if(console.log(),console.log(`  ${colors_1.c.cyan(colors_1.c.bold("⚡ AdminDB"))}${colors_1.c.dim(versionStr)}`),console.log(),console.log(`  ${colors_1.c.green("➜")}  ${colors_1.c.bold("Local:")}    ${colors_1.c.cyan(localUrl)}`),isAnyHost){const netIp=function(){try{const nets=node_os_1.default.networkInterfaces();for(const name of Object.keys(nets))for(const net of nets[name]??[])if("IPv4"===net.family&&!net.internal)return net.address}catch{}}();if(netIp){const netUrl=`http://${netIp}:${config.port}${config.basePath}/`;console.log(`  ${colors_1.c.green("➜")}  ${colors_1.c.bold("Network:")}  ${colors_1.c.cyan(netUrl)}`)}}if(useManager){const modeDesc=config.serverless?"Manager [Serverless Read-Only]":config.readonly?"Manager [Read-Only]":"Manager";if(console.log(`  ${colors_1.c.green("➜")}  ${colors_1.c.bold("Mode:")}     ${modeDesc}`),args.configPath){const count=Object.keys(connections??{}).length;console.log(`  ${colors_1.c.green("➜")}  ${colors_1.c.bold("Config:")}   ${colors_1.c.cyan(args.configPath)}${count?` (${count} connection(s))`:""}`)}if(hasConnections)for(const[name,target]of Object.entries(connections)){const sanitized=target.replace(/:([^@]+)@/,":****@"),engine=target.startsWith("postgres://")||target.startsWith("postgresql://")?"PostgreSQL":"SQLite";console.log(`     ${colors_1.c.dim("•")} ${colors_1.c.bold(name)}: ${colors_1.c.cyan(engine)} ${colors_1.c.dim(sanitized)}`)}else managerDir&&console.log(`  ${colors_1.c.green("➜")}  ${colors_1.c.bold("Directory:")}${colors_1.c.dim(` ${managerDir}`)}`);allowBrowse?browseRoot&&console.log(`  ${colors_1.c.green("➜")}  ${colors_1.c.bold("Browse:")}   ${colors_1.c.dim(`Limited to ${browseRoot}`)}`):console.log(`  ${colors_1.c.green("➜")}  ${colors_1.c.bold("Browse:")}   ${colors_1.c.dim("Disabled (configured databases only)")}`)}else{const modeDesc=config.serverless?"Single DB [Serverless Read-Only]":config.readonly?"Single DB [Read-Only]":"Single DB";if(console.log(`  ${colors_1.c.green("➜")}  ${colors_1.c.bold("Mode:")}     ${modeDesc}`),args.configPath&&console.log(`  ${colors_1.c.green("➜")}  ${colors_1.c.bold("Config:")}   ${colors_1.c.cyan(args.configPath)}`),isPg){const sanitized=explicitFile?.replace(/:([^@]+)@/,":****@");console.log(`  ${colors_1.c.green("➜")}  ${colors_1.c.bold("Engine:")}   ${colors_1.c.cyan("PostgreSQL")}`),console.log(`  ${colors_1.c.green("➜")}  ${colors_1.c.bold("Database:")} ${sanitized}`)}else console.log(`  ${colors_1.c.green("➜")}  ${colors_1.c.bold("Engine:")}   ${colors_1.c.cyan("SQLite")}`),console.log(`  ${colors_1.c.green("➜")}  ${colors_1.c.bold("Database:")} ${explicitFile}`)}if(authEnabled){"admin"===authUsername&&(!authPassword||"admin"===authPassword||authPassword===auth_1.DEFAULT_PASSWORD_HASH)?(console.log(`  ${colors_1.c.green("➜")}  ${colors_1.c.bold("Auth:")}     User: ${colors_1.c.bold(authUsername)} ${colors_1.c.yellow("(default password)")}`),console.log(),console.log(`  ${colors_1.c.yellow("⚠")}  ${colors_1.c.yellow("Default password in use (admin).")} Generate a secure hash with:`),console.log(`     ${colors_1.c.dim("npm run generatehash")} and set ${colors_1.c.cyan("ADMINDB_PASSWORD")} or ${colors_1.c.cyan("-P <hash>")}`)):console.log(`  ${colors_1.c.green("➜")}  ${colors_1.c.bold("Auth:")}     User: ${colors_1.c.bold(authUsername)}`)}else console.log(`  ${colors_1.c.yellow("➜")}  ${colors_1.c.bold("Auth:")}     ${colors_1.c.yellow("Disabled (--no-auth)")}`),console.log(`     ${colors_1.c.dim("Warning: Anyone with network access can view and modify databases.")}`);console.log()}),shutdown=signal=>{console.log(`\n  ${colors_1.c.dim(`Received ${signal}, shutting down…`)}`),server.close(()=>{console.log(`  ${colors_1.c.green("✓")} ${colors_1.c.dim("AdminDB stopped.")}\n`),process.exit(0)}),setTimeout(()=>process.exit(0),2e3).unref()};process.on("SIGINT",()=>shutdown("SIGINT")),process.on("SIGTERM",()=>shutdown("SIGTERM"))};const express_1=__importDefault(require("express")),node_os_1=__importDefault(require("node:os")),node_path_1=__importDefault(require("node:path")),app_1=require("../app"),config_1=require("./config"),logger_1=require("../utils/logger"),manager_1=require("../db/manager"),args_1=require("./args"),auth_1=require("../auth"),colors_1=require("../utils/colors");
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCli = runCli;
+const express_1 = __importDefault(require("express"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const app_1 = require("../app");
+const config_1 = require("./config");
+const logger_1 = require("../utils/logger");
+const manager_1 = require("../db/manager");
+const args_1 = require("./args");
+const auth_1 = require("../auth");
+const common_1 = require("../utils/common");
+const colors_1 = require("../utils/colors");
+function runCli() {
+    const env = (0, config_1.loadConfig)();
+    const parsed = (0, args_1.parseArgs)(process.argv.slice(2));
+    if (parsed.error) {
+        console.error(colors_1.c.red(colors_1.c.bold(`Error: ${parsed.error}`)));
+        console.error();
+        console.error((0, args_1.helpText)());
+        process.exit(1);
+    }
+    const args = parsed.args;
+    if (args.help) {
+        console.log((0, args_1.helpText)());
+        process.exit(0);
+    }
+    if (args.version) {
+        console.log((0, args_1.versionText)());
+        process.exit(0);
+    }
+    const authEnabled = args.auth !== undefined ? args.auth : env.auth;
+    const authUsername = args.authUsername ?? env.authUsername ?? 'admin';
+    const authPassword = args.authPassword ?? env.authPassword;
+    const authSecret = args.authSecret ?? env.authSecret;
+    const serverless = args.serverless !== undefined ? args.serverless : env.serverless;
+    const readonly = serverless || args.readonly || env.readonly;
+    const connections = args.connections ?? env.connections;
+    const hasConnections = Boolean(connections && Object.keys(connections).length > 0);
+    const config = {
+        host: args.host ?? env.host,
+        port: args.port ?? env.port,
+        dbPath: args.dbPath ?? env.dbPath,
+        connection: args.connection ?? env.connection,
+        connections,
+        dbDir: args.dbDir ?? env.dbDir,
+        dbFiles: args.dbFiles ?? env.dbFiles,
+        basePath: (args.basePath ?? env.basePath).replace(/\/+$/, ''),
+        logLevel: args.logLevel ?? env.logLevel,
+        readonly,
+        serverless,
+        auth: authEnabled
+            ? {
+                enabled: true,
+                username: authUsername,
+                password: authPassword,
+                secret: authSecret,
+            }
+            : false,
+    };
+    const logger = (0, logger_1.createLogger)(config.logLevel, 'admindb');
+    const app = (0, express_1.default)();
+    app.disable('x-powered-by');
+    const hasDir = Boolean(config.dbDir);
+    const hasFiles = Boolean(config.dbFiles && config.dbFiles.length > 0);
+    const explicitFile = args.connection || args.dbPath || config.connection || config.dbPath;
+    const isPg = Boolean(explicitFile && (0, common_1.isPostgresConnectionString)(explicitFile));
+    const singleFileOnly = !hasConnections && (Boolean(explicitFile) || isPg) && !hasDir && !hasFiles;
+    const useManager = !singleFileOnly;
+    const managerFiles = [...(config.dbFiles ?? [])];
+    if (useManager && explicitFile && !hasConnections)
+        managerFiles.push(explicitFile);
+    const managerDir = hasDir ? config.dbDir : hasFiles || explicitFile || hasConnections ? undefined : process.cwd();
+    const allowBrowse = useManager && (hasDir || (!hasFiles && !explicitFile && !hasConnections));
+    const browseRoot = hasDir ? node_path_1.default.resolve(config.dbDir) : undefined;
+    const router = useManager
+        ? (0, app_1.createRouter)({
+            manager: new manager_1.DbManager({ dir: managerDir, files: managerFiles, connections, readonly: config.readonly }, logger),
+            basePath: config.basePath,
+            logger,
+            readonly: config.readonly,
+            serverless: config.serverless,
+            allowBrowse,
+            browseRoot,
+            auth: config.auth,
+        })
+        : (0, app_1.createRouter)({
+            dbPath: explicitFile,
+            connection: explicitFile,
+            basePath: config.basePath,
+            logger,
+            readonly: config.readonly,
+            serverless: config.serverless,
+            auth: config.auth,
+        });
+    app.use(config.basePath || '/', router);
+    function getNetworkIp() {
+        try {
+            const nets = node_os_1.default.networkInterfaces();
+            for (const name of Object.keys(nets)) {
+                for (const net of nets[name] ?? []) {
+                    if (net.family === 'IPv4' && !net.internal) {
+                        return net.address;
+                    }
+                }
+            }
+        }
+        catch {
+        }
+        return undefined;
+    }
+    const server = app.listen(config.port, config.host, () => {
+        const v = (0, args_1.getPackageVersion)();
+        const versionStr = v ? ` v${v}` : '';
+        const isAnyHost = config.host === '0.0.0.0' || config.host === '::' || config.host === '';
+        const localHost = isAnyHost ? 'localhost' : config.host;
+        const localUrl = `http://${localHost}:${config.port}${config.basePath}/`;
+        console.log();
+        console.log(`  ${colors_1.c.cyan(colors_1.c.bold('⚡ AdminDB'))}${colors_1.c.dim(versionStr)}`);
+        console.log();
+        console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Local:')}    ${colors_1.c.cyan(localUrl)}`);
+        if (isAnyHost) {
+            const netIp = getNetworkIp();
+            if (netIp) {
+                const netUrl = `http://${netIp}:${config.port}${config.basePath}/`;
+                console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Network:')}  ${colors_1.c.cyan(netUrl)}`);
+            }
+        }
+        if (useManager) {
+            const modeDesc = config.serverless
+                ? 'Manager [Serverless Read-Only]'
+                : config.readonly
+                    ? 'Manager [Read-Only]'
+                    : 'Manager';
+            console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Mode:')}     ${modeDesc}`);
+            if (args.configPath) {
+                const count = Object.keys(connections ?? {}).length;
+                console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Config:')}   ${colors_1.c.cyan(args.configPath)}${count ? ` (${count} connection(s))` : ''}`);
+            }
+            if (hasConnections) {
+                for (const [name, target] of Object.entries(connections)) {
+                    const sanitized = (0, common_1.sanitizeConnectionString)(target);
+                    const isTargetPg = (0, common_1.isPostgresConnectionString)(target);
+                    const engine = isTargetPg ? 'PostgreSQL' : 'SQLite';
+                    console.log(`     ${colors_1.c.dim('•')} ${colors_1.c.bold(name)}: ${colors_1.c.cyan(engine)} ${colors_1.c.dim(sanitized)}`);
+                }
+            }
+            else if (managerDir) {
+                console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Directory:')}${colors_1.c.dim(` ${managerDir}`)}`);
+            }
+            if (!allowBrowse) {
+                console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Browse:')}   ${colors_1.c.dim('Disabled (configured databases only)')}`);
+            }
+            else if (browseRoot) {
+                console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Browse:')}   ${colors_1.c.dim(`Limited to ${browseRoot}`)}`);
+            }
+        }
+        else {
+            const modeDesc = config.serverless
+                ? 'Single DB [Serverless Read-Only]'
+                : config.readonly
+                    ? 'Single DB [Read-Only]'
+                    : 'Single DB';
+            console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Mode:')}     ${modeDesc}`);
+            if (args.configPath) {
+                console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Config:')}   ${colors_1.c.cyan(args.configPath)}`);
+            }
+            if (isPg) {
+                const sanitized = (0, common_1.sanitizeConnectionString)(explicitFile || '');
+                console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Engine:')}   ${colors_1.c.cyan('PostgreSQL')}`);
+                console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Database:')} ${sanitized}`);
+            }
+            else {
+                console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Engine:')}   ${colors_1.c.cyan('SQLite')}`);
+                console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Database:')} ${explicitFile}`);
+            }
+        }
+        if (authEnabled) {
+            const isDefaultPass = authUsername === 'admin' &&
+                (!authPassword || authPassword === 'admin' || authPassword === auth_1.DEFAULT_PASSWORD_HASH);
+            if (isDefaultPass) {
+                console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Auth:')}     User: ${colors_1.c.bold(authUsername)} ${colors_1.c.yellow('(default password)')}`);
+                console.log();
+                console.log(`  ${colors_1.c.yellow('⚠')}  ${colors_1.c.yellow('Default password in use (admin).')} Generate a secure hash with:`);
+                console.log(`     ${colors_1.c.dim('npm run generatehash')} and set ${colors_1.c.cyan('ADMINDB_PASSWORD')} or ${colors_1.c.cyan('-P <hash>')}`);
+            }
+            else {
+                console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Auth:')}     User: ${colors_1.c.bold(authUsername)}`);
+            }
+        }
+        else {
+            console.log(`  ${colors_1.c.yellow('➜')}  ${colors_1.c.bold('Auth:')}     ${colors_1.c.yellow('Disabled (--no-auth)')}`);
+            console.log(`     ${colors_1.c.dim('Warning: Anyone with network access can view and modify databases.')}`);
+        }
+        console.log();
+    });
+    const shutdown = (signal) => {
+        console.log(`\n  ${colors_1.c.dim(`Received ${signal}, shutting down…`)}`);
+        server.close(() => {
+            console.log(`  ${colors_1.c.green('✓')} ${colors_1.c.dim('AdminDB stopped.')}\n`);
+            process.exit(0);
+        });
+        setTimeout(() => process.exit(0), 2000).unref();
+    };
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+}

package/dist/cli.js

@@ -1,2 +1,5 @@
 #!/usr/bin/env node
-Object.defineProperty(exports,"__esModule",{value:!0});(0,require("./cli/runner").runCli)();
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const runner_1 = require("./cli/runner");
+(0, runner_1.runCli)();

package/dist/data/chain.d.ts

@@ -0,0 +1 @@
+import type {IDatabase,TableInfoData} from '../db/index';import{type ColumnGeneratorConfig,type ColumnPlan,type ErChainConfig,type ErChainResult,type ErChainScope} from './types';export interface ErGraphNode{name:string;info:TableInfoData;columns:ColumnGeneratorConfig[];parents:{table:string; from :string;to:string;notnull:boolean;}[];children:{table:string; from :string;to:string;notnull:boolean;}[];hasSelfRef:boolean;depth:number;}export declare function buildErGraph(tables:TableInfoData[]):Map<string,ErGraphNode>;export declare function resolveErChain(graph:Map<string,ErGraphNode>,rootTable:string,scope?:ErChainScope):ErGraphNode[];export declare function topologicalSort(nodes:ErGraphNode[]):{sorted:ErGraphNode[];cycleDetected:boolean;cycleTables:string[];};export declare function getErChainConfig(db:IDatabase,rootTable:string,scope?:ErChainScope):Promise<ErChainConfig>;export declare function generateChainRows(db:IDatabase,chainConfig:ErChainConfig,customPlans?:Record<string,Record<string,ColumnPlan>>,customCounts?:Record<string,number>,truncate?:boolean):Promise<ErChainResult>;export declare function buildChainInsertSql(executionOrder:string[],tableResults:ErChainResult['tableResults']):string;export declare function executeChainInsert(db:IDatabase,chainResult:ErChainResult,truncate?:boolean):Promise<{inserted:Record<string,number>;totalInserted:number;elapsedMs:number;warnings:string[];}>;