admindb 2.1.0 → 2.2.1

package/dist/auth/routes.js

@@ -4,11 +4,7 @@ exports.registerAuthRoutes = registerAuthRoutes;
 const types_1 = require("./types");
 const middleware_1 = require("./middleware");
 const crypto_1 = require("./crypto");
-/**
- * Registers /login and /logout routes.
- */
 function registerAuthRoutes(router, config, basePath, logger) {
-    // GET /login - render login screen
     router.get('/login', (req, res) => {
         if (!config.enabled) {
             return res.redirect(`${basePath}/`);
@@ -27,7 +23,6 @@ function registerAuthRoutes(router, config, basePath, logger) {
             error: req.query.error ? String(req.query.error) : null,
         });
     });
-    // POST /login - process login submission
     router.post('/login', (req, res) => {
         if (!config.enabled) {
             return res.redirect(`${basePath}/`);
@@ -51,7 +46,6 @@ function registerAuthRoutes(router, config, basePath, logger) {
                 error: 'Invalid username or password. Please check your credentials.',
             });
         }
-        // Successful authentication: issue signed session cookie
         const token = (0, crypto_1.createSessionToken)(config.username, config.secret, config.sessionDurationMs);
         const maxAgeSec = Math.floor(config.sessionDurationMs / 1000);
         const expiresUtc = new Date(Date.now() + config.sessionDurationMs).toUTCString();
@@ -63,7 +57,6 @@ function registerAuthRoutes(router, config, basePath, logger) {
         const target = nextUrl.startsWith('/') ? nextUrl : `${basePath}/`;
         res.redirect(target);
     });
-    // POST & GET /logout - clear session and redirect to login
     const handleLogout = (req, res) => {
         const cookiePath = basePath || '/';
         res.setHeader('Set-Cookie', `${types_1.SESSION_COOKIE_NAME}=; Path=${cookiePath}; Max-Age=0; Expires=Thu, 01 Jan 1970 00:00:00 GMT; HttpOnly; SameSite=Lax`);
@@ -75,4 +68,3 @@ function registerAuthRoutes(router, config, basePath, logger) {
     router.post('/logout', handleLogout);
     router.get('/logout', handleLogout);
 }
-//# sourceMappingURL=routes.js.map

package/dist/auth/types.d.ts

@@ -1,35 +1 @@
-export interface AuthConfig {
-    /**
-     * Whether authentication is enabled.
-     * Set to `false` to disable protection entirely (e.g. for development or custom upstream auth).
-     * Defaults to `true`.
-     */
-    enabled?: boolean;
-    /** Admin username. Defaults to `process.env.ADMINDB_USERNAME` or `'admin'`. */
-    username?: string;
-    /**
-     * Admin password or password hash (e.g. `scrypt:<salt>:<hash>`).
-     * Generate a hash using `npm run generatehash`.
-     * Defaults to `process.env.ADMINDB_PASSWORD` or the hardcoded default hash for `'admin'`.
-     */
-    password?: string;
-    /** Secret key used to sign session cookies. Defaults to `process.env.ADMINDB_SECRET` or auto-generated. */
-    secret?: string;
-    /** Session expiration time in milliseconds. Defaults to 7 days (604800000 ms). */
-    sessionDurationMs?: number;
-}
-export interface ResolvedAuthConfig {
-    enabled: boolean;
-    username: string;
-    password: string;
-    secret: string;
-    sessionDurationMs: number;
-    isDefaultPassword: boolean;
-}
-export declare const DEFAULT_USERNAME = "admin";
-/**
- * Hardcoded default scrypt hash for password 'admin' (salt: d9f2e64b8a1c3d5e7f0a2b4c6e801357, keyLen: 64).
- */
-export declare const DEFAULT_PASSWORD_HASH = "scrypt:d9f2e64b8a1c3d5e7f0a2b4c6e801357:cb3032b16f29c8d44f75c779f070c61c846b17eb333d07596ceb8470fc1b4c06cc720c08796ebc86937dab28a3ef580ced38a71c940fd4a169fd2e9cb9fa40e2";
-export declare const DEFAULT_SESSION_DURATION_MS: number;
-export declare const SESSION_COOKIE_NAME = "admindb_session";
+export interface AuthConfig{enabled?:boolean;username?:string;password?:string;secret?:string;sessionDurationMs?:number;}export interface ResolvedAuthConfig{enabled:boolean;username:string;password:string;secret:string;sessionDurationMs:number;isDefaultPassword:boolean;}export declare const DEFAULT_USERNAME="admin";export declare const DEFAULT_PASSWORD_HASH="scrypt:d9f2e64b8a1c3d5e7f0a2b4c6e801357:cb3032b16f29c8d44f75c779f070c61c846b17eb333d07596ceb8470fc1b4c06cc720c08796ebc86937dab28a3ef580ced38a71c940fd4a169fd2e9cb9fa40e2";export declare const DEFAULT_SESSION_DURATION_MS:number;export declare const SESSION_COOKIE_NAME="admindb_session";

package/dist/auth/types.js

@@ -2,10 +2,6 @@
 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';
-/**
- * Hardcoded default scrypt hash for password 'admin' (salt: d9f2e64b8a1c3d5e7f0a2b4c6e801357, keyLen: 64).
- */
 exports.DEFAULT_PASSWORD_HASH = 'scrypt:d9f2e64b8a1c3d5e7f0a2b4c6e801357:cb3032b16f29c8d44f75c779f070c61c846b17eb333d07596ceb8470fc1b4c06cc720c08796ebc86937dab28a3ef580ced38a71c940fd4a169fd2e9cb9fa40e2';
-exports.DEFAULT_SESSION_DURATION_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+exports.DEFAULT_SESSION_DURATION_MS = 7 * 24 * 60 * 60 * 1000;
 exports.SESSION_COOKIE_NAME = 'admindb_session';
-//# sourceMappingURL=types.js.map

package/dist/cli/args.d.ts

@@ -1,45 +1 @@
-import type { LogLevel } from '../utils/logger';
-export interface CliArgs {
-    help: boolean;
-    version: boolean;
-    /** Bind host/interface (`--host`, `-H`). */
-    host?: string;
-    /** Port to listen on (`--port`, `-p`). */
-    port?: number;
-    /** A single database file to open directly (`--open`/`--db`/`--file`/`--db-path`). */
-    dbPath?: string;
-    /** PostgreSQL or database connection string (`--connection`/`--conn`/`--pg`). */
-    connection?: string;
-    /** Database connections map (from JSON config file). */
-    connections?: Record<string, string>;
-    /** Path to a JSON configuration file (`--config`, `-C`). */
-    configPath?: string;
-    /** Directory of database files to manage (`--dir`/`--folder`/`--db-dir`, `-d`). */
-    dbDir?: string;
-    /** Explicit database file paths (`--files`/`--db-files`). */
-    dbFiles?: string[];
-    /** URL prefix to serve under (`--base-path`/`--base`, `-b`). */
-    basePath?: string;
-    /** Log level filter (`--log-level`, `-l`). */
-    logLevel?: LogLevel;
-    /** Open databases read-only (`--readonly`, `-r`). */
-    readonly: boolean;
-    /** Serverless mode (enforces read-only database operations) (`--serverless`). */
-    serverless?: boolean;
-    /** Whether authentication is enabled (defaults to true). Set to false via `--no-auth`. */
-    auth?: boolean;
-    /** Custom admin username (`--username`/`--user`/`--auth-username`, `-u`). */
-    authUsername?: string;
-    /** Custom admin password (`--password`/`--pass`/`--auth-password`, `-P`). */
-    authPassword?: string;
-    /** Secret key for session cookie signing (`--auth-secret`/`--secret`). */
-    authSecret?: string;
-}
-export declare function helpText(): string;
-/** The installed `admindb` package version (from package.json), or '' when unknown. */
-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 function getPackageVersion():string;export declare function versionText():string;export declare function parseArgs(argv:string[]):{args:CliArgs;error?:string;};

package/dist/cli/args.js

@@ -7,14 +7,9 @@ exports.helpText = helpText;
 exports.getPackageVersion = getPackageVersion;
 exports.versionText = versionText;
 exports.parseArgs = parseArgs;
-/**
- * Command-line argument parsing for the standalone `admindb` server.
- *
- * The CLI supports flags to pick the port/host, open a single database file,
- * manage a folder of databases, or pass a JSON config file with multiple connections.
- */
 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() {
@@ -85,7 +80,6 @@ function packageVersion() {
         return '';
     }
 }
-/** The installed `admindb` package version (from package.json), or '' when unknown. */
 function getPackageVersion() {
     return packageVersion();
 }
@@ -93,7 +87,6 @@ function versionText() {
     const v = packageVersion();
     return v ? `admindb v${v}` : 'admindb';
 }
-/** True when a token is exactly a flag or `flag=value` (for long flags). */
 function isFlag(tok, ...names) {
     return names.includes(tok) || names.some((n) => n.length > 2 && tok.startsWith(n + '='));
 }
@@ -185,7 +178,7 @@ function parseArgs(argv) {
             if (v === undefined)
                 return invalid('Missing value for --open / --db-path.');
             args.dbPath = v;
-            if (v.startsWith('postgres://') || v.startsWith('postgresql://')) {
+            if ((0, common_1.isPostgresConnectionString)(v)) {
                 args.connection = v;
             }
         }
@@ -263,7 +256,7 @@ function parseArgs(argv) {
     }
     const p = positional[0];
     if (p) {
-        if (p.startsWith('postgres://') || p.startsWith('postgresql://')) {
+        if ((0, common_1.isPostgresConnectionString)(p)) {
             args.connection = p;
             args.dbPath = p;
         }
@@ -325,4 +318,3 @@ function parseArgs(argv) {
     }
     return { args };
 }
-//# sourceMappingURL=args.js.map

package/dist/cli/config.d.ts

@@ -1,56 +1 @@
-import type { LogLevel } from '../utils/logger';
-export interface DatabaseConfigFile {
-    /** Database connections mapped by name: { "name": "postgresql://...", "name1": "postgresql://..." } */
-    connections?: Record<string, string>;
-    /** Single database connection string */
-    connection?: string;
-    /** Port override */
-    port?: number;
-    /** Host override */
-    host?: string;
-    /** Base path */
-    basePath?: string;
-    /** Readonly flag */
-    readonly?: boolean;
-    /** Serverless flag */
-    serverless?: boolean;
-    /** Auth options */
-    auth?: boolean | {
-        username?: string;
-        password?: string;
-        secret?: string;
-    };
-    /** Log level */
-    logLevel?: LogLevel;
-}
-export declare function parseConfigFile(filePath: string): DatabaseConfigFile | null;
-export interface Config {
-    host: string;
-    port: number;
-    /** Single-database file or connection string. */
-    dbPath: string;
-    /** Database connection string (PostgreSQL or SQLite). */
-    connection?: string;
-    /** Named database connections map. */
-    connections?: Record<string, 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;
-    /** Serverless environment mode (enforces read-only). */
-    serverless: boolean;
-    /** Whether authentication is enabled (default: true). */
-    auth: boolean;
-    /** Custom admin username (default: 'admin'). */
-    authUsername?: string;
-    /** Custom admin password (default: 'admin'). */
-    authPassword?: string;
-    /** Custom secret for signing session cookies. */
-    authSecret?: string;
-}
-/** Load configuration from environment variables with sensible defaults. */
-export declare function loadConfig(env?: NodeJS.ProcessEnv): Config;
+import type {LogLevel} from '../utils/logger';export interface DatabaseConfigFile{connections?:Record<string,string>;connection?:string;port?:number;host?:string;basePath?:string;readonly ?:boolean;serverless?:boolean;auth?:boolean|{username?:string;password?:string;secret?:string;};logLevel?:LogLevel;}export declare function parseConfigFile(filePath:string):DatabaseConfigFile|null;export interface Config{host:string;port:number;dbPath:string;connection?:string;connections?:Record<string,string>;dbDir?:string;dbFiles?:string[];basePath:string;logLevel:LogLevel;readonly :boolean;serverless:boolean;auth:boolean;authUsername?:string;authPassword?:string;authSecret?:string;}export declare function loadConfig(env?:NodeJS.ProcessEnv):Config;

package/dist/cli/config.js

@@ -20,7 +20,6 @@ function parseConfigFile(filePath) {
             return null;
         const result = {};
         const conns = {};
-        // 1. If parsed has a nested "databases" or "connections" map
         const topDbs = parsed.databases || parsed.connections;
         if (topDbs && typeof topDbs === 'object' && !Array.isArray(topDbs)) {
             for (const [k, v] of Object.entries(topDbs)) {
@@ -31,7 +30,6 @@ function parseConfigFile(filePath) {
                 }
             }
         }
-        // 2. Direct key-value map of { "name": "postgresql://...", "name1": "postgresql://..." }
         for (const [k, v] of Object.entries(parsed)) {
             if (['databases', 'connections', 'port', 'host', 'basePath', 'readonly', 'serverless', 'auth', 'logLevel', 'username', 'password', 'secret'].includes(k)) {
                 continue;
@@ -70,7 +68,6 @@ function parseConfigFile(filePath) {
         throw new Error(`Failed to parse configuration file "${filePath}": ${(0, common_1.errorMessage)(err)}`);
     }
 }
-/** Load configuration from environment variables with sensible defaults. */
 function loadConfig(env = process.env) {
     const portRaw = env.ADMINDB_PORT ?? env.PORT ?? '45531';
     const port = Number.parseInt(portRaw, 10);
@@ -97,7 +94,6 @@ function loadConfig(env = process.env) {
             }
         }
         catch {
-            /* ignore */
         }
     }
     const configPath = env.ADMINDB_CONFIG;
@@ -130,4 +126,3 @@ function loadConfig(env = process.env) {
         authSecret: (env.ADMINDB_SECRET ?? env.SESSION_SECRET) ? String(env.ADMINDB_SECRET ?? env.SESSION_SECRET).trim() : undefined,
     };
 }
-//# sourceMappingURL=config.js.map

package/dist/cli/index.d.ts

@@ -1,4 +1 @@
-export * from './args';
-export * from '../utils/colors';
-export * from './config';
-export * from './runner';
+export * from './args';export * from '../utils/colors';export * from './config';export * from './runner';

package/dist/cli/index.js

@@ -18,4 +18,3 @@ __exportStar(require("./args"), exports);
 __exportStar(require("../utils/colors"), exports);
 __exportStar(require("./config"), exports);
 __exportStar(require("./runner"), exports);
-//# sourceMappingURL=index.js.map

package/dist/cli/runner.d.ts

@@ -1 +1 @@
-export declare function runCli(): void;
+export declare function runCli():void;

package/dist/cli/runner.js

@@ -13,6 +13,7 @@ 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)();
@@ -32,7 +33,6 @@ function runCli() {
         console.log((0, args_1.versionText)());
         process.exit(0);
     }
-    // Merge CLI flags over environment variables.
     const authEnabled = args.auth !== undefined ? args.auth : env.auth;
     const authUsername = args.authUsername ?? env.authUsername ?? 'admin';
     const authPassword = args.authPassword ?? env.authPassword;
@@ -65,17 +65,10 @@ function runCli() {
     const logger = (0, logger_1.createLogger)(config.logLevel, 'admindb');
     const app = (0, express_1.default)();
     app.disable('x-powered-by');
-    // Mode selection:
-    //  - Multiple database connections from JSON config -> Manager mode.
-    //  - A specific single file / connection without multiple connections -> single-database mode.
-    //  - Otherwise -> manager mode.
     const hasDir = Boolean(config.dbDir);
     const hasFiles = Boolean(config.dbFiles && config.dbFiles.length > 0);
-    const explicitFile = args.connection ??
-        config.connection ??
-        args.dbPath ??
-        (process.env.ADMINDB_DB_PATH || process.env.ADMINDB_PATH || process.env.DB_PATH ? config.dbPath : undefined);
-    const isPg = Boolean(explicitFile && (explicitFile.startsWith('postgres://') || explicitFile.startsWith('postgresql://')));
+    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 ?? [])];
@@ -117,7 +110,6 @@ function runCli() {
             }
         }
         catch {
-            /* ignore */
         }
         return undefined;
     }
@@ -138,7 +130,6 @@ function runCli() {
                 console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Network:')}  ${colors_1.c.cyan(netUrl)}`);
             }
         }
-        // Mode & Target Info
         if (useManager) {
             const modeDesc = config.serverless
                 ? 'Manager [Serverless Read-Only]'
@@ -152,8 +143,8 @@ function runCli() {
             }
             if (hasConnections) {
                 for (const [name, target] of Object.entries(connections)) {
-                    const sanitized = target.replace(/:([^@]+)@/, ':****@');
-                    const isTargetPg = target.startsWith('postgres://') || target.startsWith('postgresql://');
+                    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)}`);
                 }
@@ -179,7 +170,7 @@ function runCli() {
                 console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Config:')}   ${colors_1.c.cyan(args.configPath)}`);
             }
             if (isPg) {
-                const sanitized = explicitFile?.replace(/:([^@]+)@/, ':****@');
+                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}`);
             }
@@ -188,7 +179,6 @@ function runCli() {
                 console.log(`  ${colors_1.c.green('➜')}  ${colors_1.c.bold('Database:')} ${explicitFile}`);
             }
         }
-        // Auth Status
         if (authEnabled) {
             const isDefaultPass = authUsername === 'admin' &&
                 (!authPassword || authPassword === 'admin' || authPassword === auth_1.DEFAULT_PASSWORD_HASH);
@@ -219,4 +209,3 @@ function runCli() {
     process.on('SIGINT', () => shutdown('SIGINT'));
     process.on('SIGTERM', () => shutdown('SIGTERM'));
 }
-//# sourceMappingURL=runner.js.map

package/dist/cli.d.ts

@@ -1,2 +1 @@
-#!/usr/bin/env node
-export {};
+#!/usr/bin/env node export{};

package/dist/cli.js

@@ -3,4 +3,3 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const runner_1 = require("./cli/runner");
 (0, runner_1.runCli)();
-//# sourceMappingURL=cli.js.map

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[];}>;