@nmakarov/cli-toolkit 0.23.0 → 0.27.0

package/dist/db.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/db/index.js","../src/errors.js"],"sourcesContent":["import knex from \"knex\";\nimport { ParamError } from \"../errors.js\";\n\nconst KNEX_DEFAULTS = {\n    testConnection: true,\n    pool: { min: 2, max: 10 },\n    acquireConnectionTimeout: 10000,\n    ssl: { rejectUnauthorized: false },\n};\n\nexport class Db {\n    static async init(context, options = {}) {\n        const defs = {\n            dbName: \"string\",\n            dbConnectionString: \"string\",\n            dbProfile: \"boolean default false\",\n        };\n        const discovered = context?.params?.getAllForModule?.(\"db\", defs) ?? {};\n        const merged = { ...discovered, ...options };\n\n        let { dbName, dbConnectionString } = merged;\n        const { dbProfile } = merged;\n\n        if (!dbName && !dbConnectionString) {\n            dbName = \"local\";\n        }\n\n        if (dbName && /^(postgresql|mysql):\\/\\//.test(dbName)) {\n            dbConnectionString = dbName;\n            dbName = undefined;\n        }\n\n        if (dbName && !dbConnectionString) {\n            const paramName = `dbConnectionString${capitalizeFirstLetter(dbName)}`;\n            dbConnectionString = await context.params.get(paramName, \"string\");\n            if (!dbConnectionString) {\n                throw new ParamError(\n                    `Db: cannot find dbConnectionString for dbName=\"${dbName}\" (looked for param \"${paramName}\")`\n                );\n            }\n        }\n\n        const config = {\n            ...KNEX_DEFAULTS,\n            connectionString: dbConnectionString,\n            name: dbName || merged.name || \"default\",\n            profile: !!dbProfile,\n            logger: context.logger,\n        };\n\n        return dbConnect(context, config);\n    }\n\n    constructor(config) {\n        if (!config || !config.connectionString) {\n            throw new ParamError(\"Db: connectionString is required\");\n        }\n\n        this.knexInstance = null;\n        this.isConnected = false;\n        this.queriesLog = [];\n\n        this.config = {\n            testConnection: true,\n            profile: false,\n            pool: { min: 2, max: 10 },\n            acquireConnectionTimeout: 10000,\n            ssl: { rejectUnauthorized: false },\n            logger: console,\n            name: \"default\",\n            ...config,\n        };\n\n        this.logger = this.config.logger;\n\n        const instance = this;\n        const callableWrapper = function () {\n            throw new Error(\"This should never be called directly\");\n        };\n        callableWrapper._instance = instance;\n\n        return new Proxy(callableWrapper, {\n            apply: (target, _thisArg, argumentsList) => {\n                const inst = target._instance;\n                if (!inst.knexInstance) {\n                    throw new Error(\"Db: Not connected. Call connect() first.\");\n                }\n                return inst.knexInstance(...argumentsList);\n            },\n            get: (target, prop) => {\n                if (prop === \"_instance\") {\n                    return target._instance;\n                }\n\n                const inst = target._instance;\n\n                const ownMethods = [\n                    \"connect\",\n                    \"disconnect\",\n                    \"testConnection\",\n                    \"tableExists\",\n                    \"getQueryLog\",\n                    \"getKnex\",\n                    \"isConnectedToDb\",\n                    \"getErrorMessage\",\n                    \"detectClient\",\n                    \"attachProfiler\",\n                ];\n\n                if (prop in inst) {\n                    const value = inst[prop];\n                    if (typeof value === \"function\" && ownMethods.includes(prop)) {\n                        return value.bind(inst);\n                    }\n                    if (typeof value !== \"function\") {\n                        return value;\n                    }\n                }\n\n                if (inst.knexInstance) {\n                    const knexProp = inst.knexInstance[prop];\n                    if (typeof knexProp === \"function\") {\n                        return knexProp.bind(inst.knexInstance);\n                    }\n                    return knexProp;\n                }\n\n                if (prop in inst) {\n                    const method = inst[prop];\n                    if (typeof method === \"function\") {\n                        return method.bind(inst);\n                    }\n                    return method;\n                }\n\n                return undefined;\n            },\n        });\n    }\n\n    detectClient(connectionString) {\n        if (connectionString.match(/^postgresql/)) {\n            return \"pg\";\n        }\n        if (connectionString.match(/^mysql/)) {\n            return \"mysql2\";\n        }\n        return null;\n    }\n\n    async connect() {\n        if (this.isConnected && this.knexInstance) {\n            this.logger.warn?.(\"[Db] Already connected\");\n            return;\n        }\n\n        const client = this.detectClient(this.config.connectionString);\n        if (!client) {\n            throw new ParamError(\n                \"Db: Cannot determine client type from connection string. Expected postgresql:// or mysql://\"\n            );\n        }\n\n        try {\n            const connectionConfig = {\n                connectionString: this.config.connectionString,\n                family: 4,\n            };\n\n            this.knexInstance = knex({\n                client,\n                connection: connectionConfig,\n                pool: this.config.pool,\n                acquireConnectionTimeout: this.config.acquireConnectionTimeout,\n                ...(this.config.ssl && { ssl: this.config.ssl }),\n            });\n\n            if (this.config.profile) {\n                this.attachProfiler();\n            }\n\n            if (this.config.testConnection) {\n                await this.testConnection();\n            }\n\n            this.isConnected = true;\n            this.logger.debug?.(\n                `[Db] Connected to database \"${this.config.name || this.config.connectionString}\"`\n            );\n        } catch (error) {\n            if (error instanceof ParamError) {\n                throw error;\n            }\n            const errorMsg = this.getErrorMessage(error);\n            throw new ParamError(`Db: Connection failed - ${errorMsg}`);\n        }\n    }\n\n    async disconnect() {\n        if (!this.knexInstance) {\n            return;\n        }\n\n        try {\n            await this.knexInstance.destroy();\n            this.knexInstance = null;\n            this.isConnected = false;\n            this.queriesLog = [];\n            this.logger.debug?.(\n                `[Db] Disconnected from database \"${this.config.name || this.config.connectionString}\"`\n            );\n        } catch (error) {\n            const errorMsg = this.getErrorMessage(error);\n            this.logger.error?.(`[Db] Error disconnecting: ${errorMsg}`);\n            throw error;\n        }\n    }\n\n    getErrorMessage(error) {\n        if (error instanceof AggregateError) {\n            const errors = error.errors || [];\n\n            if (errors.length > 0) {\n                const firstError = errors[0];\n                const firstErrorMsg =\n                    firstError instanceof Error ? firstError.message : String(firstError);\n\n                const allSimilar = errors.every((e) => {\n                    const msg = e instanceof Error ? e.message : String(e);\n                    const codeMatch = msg.match(/^(\\w+)\\s/);\n                    const firstCodeMatch = firstErrorMsg.match(/^(\\w+)\\s/);\n                    return codeMatch && firstCodeMatch && codeMatch[1] === firstCodeMatch[1];\n                });\n\n                if (allSimilar && errors.length > 1) {\n                    const addresses = errors\n                        .map((e) => {\n                            const msg = e instanceof Error ? e.message : String(e);\n                            const addrMatch = msg.match(/([:\\d.]+:\\d+)/);\n                            return addrMatch ? addrMatch[1] : null;\n                        })\n                        .filter(Boolean);\n\n                    if (addresses.length > 0) {\n                        const codeMatch = firstErrorMsg.match(/^(\\w+)\\s/);\n                        const code = codeMatch ? codeMatch[1] : \"Connection error\";\n                        return `${code} (tried: ${addresses.join(\", \")})`;\n                    }\n                }\n\n                const uniqueMessages = [\n                    ...new Set(\n                        errors.map((e) => (e instanceof Error ? e.message : String(e)))\n                    ),\n                ];\n\n                if (uniqueMessages.length === 1) {\n                    return uniqueMessages[0];\n                }\n\n                return uniqueMessages.join(\"; \");\n            }\n\n            return error.message || \"Multiple errors occurred\";\n        }\n\n        if (error instanceof Error) {\n            const code = error.code;\n            if (code) {\n                return `${code}: ${error.message || String(error)}`;\n            }\n            return error.message || String(error);\n        }\n\n        if (typeof error === \"string\") {\n            return error;\n        }\n\n        if (error && typeof error === \"object\" && \"message\" in error) {\n            const msg = String(error.message);\n            const code = error.code;\n            if (code) {\n                return `${code}: ${msg}`;\n            }\n            return msg;\n        }\n\n        return String(error) || \"Unknown error\";\n    }\n\n    async testConnection() {\n        if (!this.knexInstance) {\n            throw new Error(\"Db: Not connected. Call connect() first.\");\n        }\n\n        try {\n            const result = await this.knexInstance.raw(\"SELECT 2+3 AS result\");\n            const isOk = result.rows?.[0]?.result === 5 || result[0]?.[0]?.result === 5;\n            this.logger.debug?.(`[Db] Connection test: ${isOk ? \"OK\" : \"FAILED\"}`);\n            return isOk;\n        } catch (error) {\n            const errorMsg = this.getErrorMessage(error);\n            this.logger.error?.(`[Db] Connection test failed: ${errorMsg}`);\n            throw new ParamError(`Db: Connection test failed - ${errorMsg}`);\n        }\n    }\n\n    attachProfiler() {\n        if (!this.knexInstance) {\n            return;\n        }\n\n        this.queriesLog = [];\n        this.knexInstance.queriesLog = this.queriesLog;\n\n        this.knexInstance.on(\"query\", (query) => {\n            query.__startTime = process.hrtime();\n        });\n\n        this.knexInstance.on(\"query-response\", (_response, query) => {\n            const [seconds, nanoseconds] = process.hrtime(query.__startTime);\n            const executionTimeMs = (seconds * 1000 + nanoseconds / 1e6).toFixed(2);\n\n            const logEntry = {\n                sql: query.sql,\n                bindings: query.bindings || [],\n                executionTimeMs,\n            };\n\n            this.queriesLog.push(logEntry);\n            this.logger.debug?.(`[Db] Query: ${query.sql} | Duration: ${executionTimeMs}ms`);\n        });\n\n        this.knexInstance.on(\"query-error\", (error, query) => {\n            this.logger.error?.(`[Db] Query failed: ${query.sql}`, error);\n        });\n    }\n\n    getQueryLog() {\n        return [...this.queriesLog];\n    }\n\n    async tableExists(tableName) {\n        if (!this.knexInstance) {\n            throw new Error(\"Db: Not connected. Call connect() first.\");\n        }\n\n        try {\n            return await this.knexInstance.schema.hasTable(tableName);\n        } catch (error) {\n            this.logger.error?.(`[Db] Error checking table existence: ${error.message}`);\n            throw error;\n        }\n    }\n\n    getKnex() {\n        if (!this.knexInstance) {\n            throw new Error(\"Db: Not connected. Call connect() first.\");\n        }\n        return this.knexInstance;\n    }\n\n    isConnectedToDb() {\n        return this.isConnected && this.knexInstance !== null;\n    }\n}\n\nfunction capitalizeFirstLetter(str) {\n    return str.charAt(0).toUpperCase() + str.slice(1);\n}\n\nasync function dbConnect(context, config) {\n    try {\n        const db = new Db(config);\n\n        context.registerCleanup(async () => {\n            await db.disconnect();\n            context.logger.debug?.(`[Db] instance \"${config.name}\" disconnected`);\n        });\n\n        await db.connect();\n\n        context.logger.debug?.(`[Db] instance \"${config.name}\" initialized`);\n\n        return db;\n    } catch (error) {\n        if (error instanceof ParamError) {\n            throw error;\n        }\n        const errorMsg = error instanceof Error ? error.message : String(error);\n        throw new ParamError(`[Db] connect error: ${errorMsg}`);\n    }\n}\n","/**\n * Error classes for the CLI toolkit\n */\n\nexport class FrameworkError extends Error {\n    constructor(message) {\n        super(message);\n        this.name = \"FrameworkError\";\n    }\n}\n\nexport class ParamError extends FrameworkError {\n    constructor(message) {\n        super(message);\n        this.name = \"ParamError\";\n    }\n}\n\nexport class InitError extends FrameworkError {\n    constructor(message) {\n        super(message);\n        this.name = \"InitError\";\n    }\n}\n\nexport class CriticalRequestError extends FrameworkError {\n    constructor(message) {\n        super(message);\n        this.name = \"CriticalRequestError\";\n    }\n}\n\nexport class ControlFlowError extends Error {\n    constructor(message) {\n        super(message);\n        this.name = \"ControlFlowError\";\n    }\n}\n\nexport class HttpClientError extends FrameworkError {\n    constructor(message,   cause) {\n        super(message);this.cause = cause;;\n        this.name = \"HttpClientError\";\n    }\n}\n\nexport class FileDatabaseError extends FrameworkError {\n    constructor(message) {\n        super(message);\n        this.name = \"FileDatabaseError\";\n    }\n}\n\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/db/index.js","../src/errors.js"],"sourcesContent":["import knex from \"knex\";\nimport { ParamError } from \"../errors.js\";\n\nconst KNEX_DEFAULTS = {\n    testConnection: true,\n    pool: { min: 2, max: 10 },\n    acquireConnectionTimeout: 10000,\n    ssl: { rejectUnauthorized: false },\n};\n\nexport class Db {\n    static async init(context, options = {}) {\n        const buildConfig = async () => {\n            const defs = {\n                dbName: \"string\",\n                dbProfile: \"boolean default false\",\n            };\n            const discovered = context?.params?.getAllForModule?.(\"db\", defs) ?? {};\n            const merged = { ...discovered, ...options };\n\n            let { dbName, dbProfile } = merged;\n            let dbConnectionString = options.dbConnectionString ?? options.connectionString;\n            let connectionParam = dbConnectionString ? \"options\" : null;\n\n            if (!dbConnectionString) {\n                const src = context?.args?.getSource?.(\"dbConnectionString\");\n                if (src === \"cli\" || src === \"overrides\" || src === \"config\") {\n                    dbConnectionString = await context.params.get(\"dbConnectionString\", \"string\");\n                    connectionParam = \"dbConnectionString\";\n                }\n            }\n\n            if (!dbConnectionString && dbName && /^(postgresql|mysql):\\/\\//.test(dbName)) {\n                dbConnectionString = dbName;\n                dbName = undefined;\n            }\n\n            if (!dbConnectionString && dbName) {\n                const paramName = `dbConnectionString${capitalizeFirstLetter(dbName)}`;\n                dbConnectionString = await context.params.get(paramName, \"string\");\n                connectionParam = paramName;\n                if (!dbConnectionString) {\n                    throw new ParamError(\n                        `Db: cannot find dbConnectionString for dbName=\"${dbName}\" (looked for param \"${paramName}\")`\n                    );\n                }\n            }\n\n            if (!dbConnectionString) {\n                dbConnectionString = await context.params.get(\"dbConnectionString\", \"string\");\n                if (dbConnectionString) {\n                    connectionParam = \"dbConnectionString\";\n                }\n            }\n\n            if (!dbConnectionString) {\n                if (!dbName) {\n                    dbName = \"local\";\n                }\n                const paramName = `dbConnectionString${capitalizeFirstLetter(dbName)}`;\n                dbConnectionString = await context.params.get(paramName, \"string\");\n                connectionParam = paramName;\n                if (!dbConnectionString) {\n                    throw new ParamError(\n                        `Db: cannot find dbConnectionString for dbName=\"${dbName}\" (looked for param \"${paramName}\")`\n                    );\n                }\n            }\n\n            const displayName = resolveDbDisplayName(\n                dbName,\n                connectionParam,\n                context?.args?.env,\n                merged.name\n            );\n\n            return {\n                ...KNEX_DEFAULTS,\n                connectionString: dbConnectionString,\n                name: displayName,\n                profile: !!dbProfile,\n                logger: context.logger,\n            };\n        };\n\n        const config = context?.params?.runWithModuleAsync\n            ? await context.params.runWithModuleAsync(\"db\", buildConfig)\n            : await buildConfig();\n\n        return dbConnect(context, config);\n    }\n\n    constructor(config) {\n        if (!config || !config.connectionString) {\n            throw new ParamError(\"Db: connectionString is required\");\n        }\n\n        this.knexInstance = null;\n        this.isConnected = false;\n        this.queriesLog = [];\n\n        this.config = {\n            testConnection: true,\n            profile: false,\n            pool: { min: 2, max: 10 },\n            acquireConnectionTimeout: 10000,\n            ssl: { rejectUnauthorized: false },\n            logger: console,\n            ...config,\n        };\n\n        this.logger = this.config.logger;\n\n        const instance = this;\n        const callableWrapper = function () {\n            throw new Error(\"This should never be called directly\");\n        };\n        callableWrapper._instance = instance;\n\n        return new Proxy(callableWrapper, {\n            apply: (target, _thisArg, argumentsList) => {\n                const inst = target._instance;\n                if (!inst.knexInstance) {\n                    throw new Error(\"Db: Not connected. Call connect() first.\");\n                }\n                return inst.knexInstance(...argumentsList);\n            },\n            get: (target, prop) => {\n                if (prop === \"_instance\") {\n                    return target._instance;\n                }\n\n                const inst = target._instance;\n\n                const ownMethods = [\n                    \"connect\",\n                    \"disconnect\",\n                    \"testConnection\",\n                    \"tableExists\",\n                    \"getQueryLog\",\n                    \"getKnex\",\n                    \"isConnectedToDb\",\n                    \"getErrorMessage\",\n                    \"detectClient\",\n                    \"attachProfiler\",\n                ];\n\n                if (prop in inst) {\n                    const value = inst[prop];\n                    if (typeof value === \"function\" && ownMethods.includes(prop)) {\n                        return value.bind(inst);\n                    }\n                    if (typeof value !== \"function\") {\n                        return value;\n                    }\n                }\n\n                if (inst.knexInstance) {\n                    const knexProp = inst.knexInstance[prop];\n                    if (typeof knexProp === \"function\") {\n                        return knexProp.bind(inst.knexInstance);\n                    }\n                    return knexProp;\n                }\n\n                if (prop in inst) {\n                    const method = inst[prop];\n                    if (typeof method === \"function\") {\n                        return method.bind(inst);\n                    }\n                    return method;\n                }\n\n                return undefined;\n            },\n        });\n    }\n\n    detectClient(connectionString) {\n        if (connectionString.match(/^postgresql/)) {\n            return \"pg\";\n        }\n        if (connectionString.match(/^mysql/)) {\n            return \"mysql2\";\n        }\n        return null;\n    }\n\n    async connect() {\n        if (this.isConnected && this.knexInstance) {\n            this.logger.warn?.(\"[Db] Already connected\");\n            return;\n        }\n\n        const client = this.detectClient(this.config.connectionString);\n        if (!client) {\n            throw new ParamError(\n                \"Db: Cannot determine client type from connection string. Expected postgresql:// or mysql://\"\n            );\n        }\n\n        try {\n            const connectionConfig = {\n                connectionString: this.config.connectionString,\n                family: 4,\n            };\n\n            this.knexInstance = knex({\n                client,\n                connection: connectionConfig,\n                pool: this.config.pool,\n                acquireConnectionTimeout: this.config.acquireConnectionTimeout,\n                ...(this.config.ssl && { ssl: this.config.ssl }),\n            });\n\n            if (this.config.profile) {\n                this.attachProfiler();\n            }\n\n            if (this.config.testConnection) {\n                await this.testConnection();\n            }\n\n            this.isConnected = true;\n            this.logger.debug?.(formatDbConnectMessage(this.config.name, this.config.connectionString));\n        } catch (error) {\n            if (error instanceof ParamError) {\n                throw error;\n            }\n            const errorMsg = this.getErrorMessage(error);\n            throw new ParamError(`Db: Connection failed - ${errorMsg}`);\n        }\n    }\n\n    async disconnect() {\n        if (!this.knexInstance) {\n            return;\n        }\n\n        try {\n            await this.knexInstance.destroy();\n            this.knexInstance = null;\n            this.isConnected = false;\n            this.queriesLog = [];\n            this.logger.debug?.(formatDbDisconnectMessage(this.config.name, this.config.connectionString));\n        } catch (error) {\n            const errorMsg = this.getErrorMessage(error);\n            this.logger.error?.(`[Db] Error disconnecting: ${errorMsg}`);\n            throw error;\n        }\n    }\n\n    getErrorMessage(error) {\n        if (error instanceof AggregateError) {\n            const errors = error.errors || [];\n\n            if (errors.length > 0) {\n                const firstError = errors[0];\n                const firstErrorMsg =\n                    firstError instanceof Error ? firstError.message : String(firstError);\n\n                const allSimilar = errors.every((e) => {\n                    const msg = e instanceof Error ? e.message : String(e);\n                    const codeMatch = msg.match(/^(\\w+)\\s/);\n                    const firstCodeMatch = firstErrorMsg.match(/^(\\w+)\\s/);\n                    return codeMatch && firstCodeMatch && codeMatch[1] === firstCodeMatch[1];\n                });\n\n                if (allSimilar && errors.length > 1) {\n                    const addresses = errors\n                        .map((e) => {\n                            const msg = e instanceof Error ? e.message : String(e);\n                            const addrMatch = msg.match(/([:\\d.]+:\\d+)/);\n                            return addrMatch ? addrMatch[1] : null;\n                        })\n                        .filter(Boolean);\n\n                    if (addresses.length > 0) {\n                        const codeMatch = firstErrorMsg.match(/^(\\w+)\\s/);\n                        const code = codeMatch ? codeMatch[1] : \"Connection error\";\n                        return `${code} (tried: ${addresses.join(\", \")})`;\n                    }\n                }\n\n                const uniqueMessages = [\n                    ...new Set(\n                        errors.map((e) => (e instanceof Error ? e.message : String(e)))\n                    ),\n                ];\n\n                if (uniqueMessages.length === 1) {\n                    return uniqueMessages[0];\n                }\n\n                return uniqueMessages.join(\"; \");\n            }\n\n            return error.message || \"Multiple errors occurred\";\n        }\n\n        if (error instanceof Error) {\n            const code = error.code;\n            if (code) {\n                return `${code}: ${error.message || String(error)}`;\n            }\n            return error.message || String(error);\n        }\n\n        if (typeof error === \"string\") {\n            return error;\n        }\n\n        if (error && typeof error === \"object\" && \"message\" in error) {\n            const msg = String(error.message);\n            const code = error.code;\n            if (code) {\n                return `${code}: ${msg}`;\n            }\n            return msg;\n        }\n\n        return String(error) || \"Unknown error\";\n    }\n\n    async testConnection() {\n        if (!this.knexInstance) {\n            throw new Error(\"Db: Not connected. Call connect() first.\");\n        }\n\n        try {\n            const result = await this.knexInstance.raw(\"SELECT 2+3 AS result\");\n            const isOk = result.rows?.[0]?.result === 5 || result[0]?.[0]?.result === 5;\n            this.logger.debug?.(`[Db] Connection test: ${isOk ? \"OK\" : \"FAILED\"}`);\n            return isOk;\n        } catch (error) {\n            const errorMsg = this.getErrorMessage(error);\n            this.logger.error?.(`[Db] Connection test failed: ${errorMsg}`);\n            throw new ParamError(`Db: Connection test failed - ${errorMsg}`);\n        }\n    }\n\n    attachProfiler() {\n        if (!this.knexInstance) {\n            return;\n        }\n\n        this.queriesLog = [];\n        this.knexInstance.queriesLog = this.queriesLog;\n\n        this.knexInstance.on(\"query\", (query) => {\n            query.__startTime = process.hrtime();\n        });\n\n        this.knexInstance.on(\"query-response\", (_response, query) => {\n            const [seconds, nanoseconds] = process.hrtime(query.__startTime);\n            const executionTimeMs = (seconds * 1000 + nanoseconds / 1e6).toFixed(2);\n\n            const logEntry = {\n                sql: query.sql,\n                bindings: query.bindings || [],\n                executionTimeMs,\n            };\n\n            this.queriesLog.push(logEntry);\n            this.logger.debug?.(`[Db] Query: ${query.sql} | Duration: ${executionTimeMs}ms`);\n        });\n\n        this.knexInstance.on(\"query-error\", (error, query) => {\n            this.logger.error?.(`[Db] Query failed: ${query.sql}`, error);\n        });\n    }\n\n    getQueryLog() {\n        return [...this.queriesLog];\n    }\n\n    async tableExists(tableName) {\n        if (!this.knexInstance) {\n            throw new Error(\"Db: Not connected. Call connect() first.\");\n        }\n\n        try {\n            return await this.knexInstance.schema.hasTable(tableName);\n        } catch (error) {\n            this.logger.error?.(`[Db] Error checking table existence: ${error.message}`);\n            throw error;\n        }\n    }\n\n    getKnex() {\n        if (!this.knexInstance) {\n            throw new Error(\"Db: Not connected. Call connect() first.\");\n        }\n        return this.knexInstance;\n    }\n\n    isConnectedToDb() {\n        return this.isConnected && this.knexInstance !== null;\n    }\n}\n\nfunction capitalizeFirstLetter(str) {\n    return str.charAt(0).toUpperCase() + str.slice(1);\n}\n\nfunction resolveDbDisplayName(dbName, connectionParam, argsEnv, mergedName) {\n    if (dbName) {\n        return dbName;\n    }\n    if (mergedName) {\n        return mergedName;\n    }\n    if (\n        connectionParam?.startsWith(\"dbConnectionString\") &&\n        connectionParam.length > \"dbConnectionString\".length\n    ) {\n        return connectionParam.slice(\"dbConnectionString\".length).toLowerCase();\n    }\n    if (connectionParam === \"dbConnectionString\" && argsEnv) {\n        return argsEnv;\n    }\n    return undefined;\n}\n\nfunction formatDbConnectMessage(name, connectionString) {\n    const endpointSuffix = formatConnectionEndpointSuffix(connectionString);\n    if (name) {\n        return `[Db] Connected to database \"${name}\"${endpointSuffix}`;\n    }\n    return `[Db] Connected${endpointSuffix}`;\n}\n\nfunction formatDbDisconnectMessage(name, connectionString) {\n    const endpointSuffix = formatConnectionEndpointSuffix(connectionString);\n    if (name) {\n        return `[Db] Disconnected from database \"${name}\"${endpointSuffix}`;\n    }\n    return `[Db] Disconnected${endpointSuffix}`;\n}\n\nfunction formatDbInstanceMessage(action, name) {\n    if (name) {\n        return `[Db] instance \"${name}\" ${action}`;\n    }\n    return `[Db] instance ${action}`;\n}\n\nfunction formatConnectionEndpointSuffix(connectionString) {\n    const endpoint = formatConnectionEndpoint(connectionString);\n    return endpoint ? ` (${endpoint})` : \"\";\n}\n\nfunction formatConnectionEndpoint(connectionString) {\n    try {\n        const url = new URL(connectionString);\n        const host = url.hostname;\n        if (!host) {\n            return null;\n        }\n\n        let port = url.port;\n        if (!port) {\n            if (url.protocol === \"postgresql:\") {\n                port = \"5432\";\n            } else if (url.protocol === \"mysql:\") {\n                port = \"3306\";\n            }\n        }\n\n        return port ? `${host}:${port}` : host;\n    } catch {\n        return null;\n    }\n}\n\nasync function dbConnect(context, config) {\n    try {\n        const db = new Db(config);\n\n        context.registerCleanup(async () => {\n            await db.disconnect();\n            context.logger.debug?.(formatDbInstanceMessage(\"disconnected\", config.name));\n        });\n\n        await db.connect();\n\n        context.logger.debug?.(formatDbInstanceMessage(\"initialized\", config.name));\n\n        return db;\n    } catch (error) {\n        if (error instanceof ParamError) {\n            throw error;\n        }\n        const errorMsg = error instanceof Error ? error.message : String(error);\n        throw new ParamError(`[Db] connect error: ${errorMsg}`);\n    }\n}\n","/**\n * Error classes for the CLI toolkit\n */\n\nexport class FrameworkError extends Error {\n    constructor(message) {\n        super(message);\n        this.name = \"FrameworkError\";\n    }\n}\n\nexport class ParamError extends FrameworkError {\n    constructor(message) {\n        super(message);\n        this.name = \"ParamError\";\n    }\n}\n\nexport class InitError extends FrameworkError {\n    constructor(message) {\n        super(message);\n        this.name = \"InitError\";\n    }\n}\n\nexport class CriticalRequestError extends FrameworkError {\n    constructor(message) {\n        super(message);\n        this.name = \"CriticalRequestError\";\n    }\n}\n\nexport class ControlFlowError extends Error {\n    constructor(message) {\n        super(message);\n        this.name = \"ControlFlowError\";\n    }\n}\n\nexport class HttpClientError extends FrameworkError {\n    constructor(message,   cause) {\n        super(message);this.cause = cause;;\n        this.name = \"HttpClientError\";\n    }\n}\n\nexport class FileDatabaseError extends FrameworkError {\n    constructor(message) {\n        super(message);\n        this.name = \"FileDatabaseError\";\n    }\n}\n\n"],"mappings":"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","names":[]}

package/dist/index.cjs

@@ -1810,46 +1810,83 @@ var Params = class _Params {
   paramGetters = [];
   trackedParams = [];
   _currentModule = "script";
-  /** Resolved early in constructor so cleanup does not read params lazily */
-  _showUsedParams = false;
+  /**
+   * Resolved early in constructor so cleanup does not read params lazily.
+   * One of: false (off) | "end" (print at exit) | "top" (print after init,
+   * via context.showUsedParamsIfNeeded()).
+   */
+  _showUsedParamsMode = false;
+  /** Guard so the dump prints at most once (top OR end, never both). */
+  _usedParamsPrinted = false;
   constructor(context, options = {}) {
     this.context = context;
     this.args = context.args;
     if (Object.keys(options).length > 0) {
       this.configure(options);
     }
-    this._showUsedParams = this.get("showUsedParams", "boolean default false");
+    this._resolveShowUsedParams();
     if (context && typeof context.registerCleanup === "function") {
       context.registerCleanup((ctx) => {
-        if (!ctx.params.getShowUsedParams()) return;
-        const byModule = ctx.params.getFiguredByModule();
-        const modules = Object.keys(byModule).sort();
-        if (modules.length === 0) return;
-        const logger = ctx.logger;
-        logger.debug("[Params]: list of used params:");
-        if (typeof logger.highlight !== "function") {
-          for (const mod of modules) {
-            logger.debug(`  [${mod}]`);
-            for (const [key, entry] of Object.entries(byModule[mod])) {
-              logger.debug(`    ${key}: ${JSON.stringify(entry.value)} (${entry.source})`);
-            }
-          }
-          return;
-        }
-        for (const mod of modules) {
-          logger.debug(`  [${mod}]`);
-          for (const [key, entry] of Object.entries(byModule[mod])) {
-            const valueStr = JSON.stringify(entry.value);
-            const display = entry.source === "default" ? valueStr : logger.highlight(valueStr);
-            logger.debug(`    ${key}: ${display} (${entry.source})`);
-          }
-        }
+        if (!ctx.params.getShowUsedParamsMode()) return;
+        ctx.params.printUsedParams(ctx.logger);
       });
     }
   }
-  /** Whether --showUsedParams was requested (resolved in constructor). */
+  /**
+   * Resolve the --showUsedParams mode. The flag is intentionally dual-typed:
+   *   (absent) / --no-showUsedParams / =false   -> false  (off)
+   *   --showUsedParams / =true                   -> "end"  (print at exit)
+   *   --showUsedParams=top                       -> "top"  (print after init)
+   * Read raw (uncoerced) from args so the string "top" isn't forced to a
+   * boolean, then track it under the "script" module for the dump itself.
+   */
+  _resolveShowUsedParams() {
+    const raw = this.args.get("showUsedParams");
+    const source = this.args.getSource?.("showUsedParams") ?? "default";
+    let mode = false;
+    if (raw === void 0 || raw === null) {
+      mode = false;
+    } else if (typeof raw === "string" && raw.trim().toLowerCase() === "top") {
+      mode = "top";
+    } else {
+      const s = typeof raw === "string" ? raw.trim().toLowerCase() : raw;
+      const falsey = s === false || s === "false" || s === "0" || s === "no" || s === "off";
+      mode = falsey ? false : "end";
+    }
+    this._showUsedParamsMode = mode;
+    this.trackParam("showUsedParams", "string", mode, raw === void 0 ? "default" : source, "script");
+    return mode;
+  }
+  /** Whether --showUsedParams was requested in any mode (truthy = on). */
   getShowUsedParams() {
-    return this._showUsedParams;
+    return this._showUsedParamsMode !== false;
+  }
+  /** Resolved mode: false | "end" | "top". */
+  getShowUsedParamsMode() {
+    return this._showUsedParamsMode;
+  }
+  /**
+   * Print the module-grouped list of figured params (the --showUsedParams
+   * dump). Idempotent: only the first call prints, so callers can invoke it
+   * at the top (long-running services) without double-printing at exit.
+   */
+  printUsedParams(logger) {
+    if (this._usedParamsPrinted) return;
+    const byModule = this.getFiguredByModule();
+    const modules = Object.keys(byModule).sort();
+    if (modules.length === 0) return;
+    this._usedParamsPrinted = true;
+    logger = logger ?? this.context?.logger ?? console;
+    const hasHighlight = typeof logger.highlight === "function";
+    logger.debug("[Params]: list of used params:");
+    for (const mod of modules) {
+      logger.debug(`  [${mod}]`);
+      for (const [key, entry] of Object.entries(byModule[mod])) {
+        const valueStr = JSON.stringify(entry.value);
+        const display = hasHighlight && entry.source !== "default" ? logger.highlight(valueStr) : valueStr;
+        logger.debug(`    ${key}: ${display} (${entry.source})`);
+      }
+    }
   }
   /**
    * Configure parameters
@@ -2117,6 +2154,18 @@ var Params = class _Params {
       this._currentModule = prev;
     }
   }
+  /**
+   * Async variant of {@link runWithModule} for modules that await params.get().
+   */
+  async runWithModuleAsync(moduleName, fn) {
+    const prev = this._currentModule;
+    this._currentModule = moduleName;
+    try {
+      return await fn();
+    } finally {
+      this._currentModule = prev;
+    }
+  }
   /**
    * Infer module name from call stack: first caller outside params/index gives path like .../src/<moduleName>/...
    */
@@ -3380,38 +3429,71 @@ var KNEX_DEFAULTS = {
 };
 var Db = class {
   static async init(context, options = {}) {
-    const defs = {
-      dbName: "string",
-      dbConnectionString: "string",
-      dbProfile: "boolean default false"
-    };
-    const discovered = context?.params?.getAllForModule?.("db", defs) ?? {};
-    const merged = { ...discovered, ...options };
-    let { dbName, dbConnectionString } = merged;
-    const { dbProfile } = merged;
-    if (!dbName && !dbConnectionString) {
-      dbName = "local";
-    }
-    if (dbName && /^(postgresql|mysql):\/\//.test(dbName)) {
-      dbConnectionString = dbName;
-      dbName = void 0;
-    }
-    if (dbName && !dbConnectionString) {
-      const paramName = `dbConnectionString${capitalizeFirstLetter(dbName)}`;
-      dbConnectionString = await context.params.get(paramName, "string");
+    const buildConfig = async () => {
+      const defs = {
+        dbName: "string",
+        dbProfile: "boolean default false"
+      };
+      const discovered = context?.params?.getAllForModule?.("db", defs) ?? {};
+      const merged = { ...discovered, ...options };
+      let { dbName, dbProfile } = merged;
+      let dbConnectionString = options.dbConnectionString ?? options.connectionString;
+      let connectionParam = dbConnectionString ? "options" : null;
       if (!dbConnectionString) {
-        throw new ParamError(
-          `Db: cannot find dbConnectionString for dbName="${dbName}" (looked for param "${paramName}")`
-        );
+        const src = context?.args?.getSource?.("dbConnectionString");
+        if (src === "cli" || src === "overrides" || src === "config") {
+          dbConnectionString = await context.params.get("dbConnectionString", "string");
+          connectionParam = "dbConnectionString";
+        }
       }
-    }
-    const config2 = {
-      ...KNEX_DEFAULTS,
-      connectionString: dbConnectionString,
-      name: dbName || merged.name || "default",
-      profile: !!dbProfile,
-      logger: context.logger
+      if (!dbConnectionString && dbName && /^(postgresql|mysql):\/\//.test(dbName)) {
+        dbConnectionString = dbName;
+        dbName = void 0;
+      }
+      if (!dbConnectionString && dbName) {
+        const paramName = `dbConnectionString${capitalizeFirstLetter(dbName)}`;
+        dbConnectionString = await context.params.get(paramName, "string");
+        connectionParam = paramName;
+        if (!dbConnectionString) {
+          throw new ParamError(
+            `Db: cannot find dbConnectionString for dbName="${dbName}" (looked for param "${paramName}")`
+          );
+        }
+      }
+      if (!dbConnectionString) {
+        dbConnectionString = await context.params.get("dbConnectionString", "string");
+        if (dbConnectionString) {
+          connectionParam = "dbConnectionString";
+        }
+      }
+      if (!dbConnectionString) {
+        if (!dbName) {
+          dbName = "local";
+        }
+        const paramName = `dbConnectionString${capitalizeFirstLetter(dbName)}`;
+        dbConnectionString = await context.params.get(paramName, "string");
+        connectionParam = paramName;
+        if (!dbConnectionString) {
+          throw new ParamError(
+            `Db: cannot find dbConnectionString for dbName="${dbName}" (looked for param "${paramName}")`
+          );
+        }
+      }
+      const displayName = resolveDbDisplayName(
+        dbName,
+        connectionParam,
+        context?.args?.env,
+        merged.name
+      );
+      return {
+        ...KNEX_DEFAULTS,
+        connectionString: dbConnectionString,
+        name: displayName,
+        profile: !!dbProfile,
+        logger: context.logger
+      };
     };
+    const config2 = context?.params?.runWithModuleAsync ? await context.params.runWithModuleAsync("db", buildConfig) : await buildConfig();
     return dbConnect(context, config2);
   }
   constructor(config2) {
@@ -3428,7 +3510,6 @@ var Db = class {
       acquireConnectionTimeout: 1e4,
       ssl: { rejectUnauthorized: false },
       logger: console,
-      name: "default",
       ...config2
     };
     this.logger = this.config.logger;
@@ -3528,9 +3609,7 @@ var Db = class {
         await this.testConnection();
       }
       this.isConnected = true;
-      this.logger.debug?.(
-        `[Db] Connected to database "${this.config.name || this.config.connectionString}"`
-      );
+      this.logger.debug?.(formatDbConnectMessage(this.config.name, this.config.connectionString));
     } catch (error) {
       if (error instanceof ParamError) {
         throw error;
@@ -3548,9 +3627,7 @@ var Db = class {
       this.knexInstance = null;
       this.isConnected = false;
       this.queriesLog = [];
-      this.logger.debug?.(
-        `[Db] Disconnected from database "${this.config.name || this.config.connectionString}"`
-      );
+      this.logger.debug?.(formatDbDisconnectMessage(this.config.name, this.config.connectionString));
     } catch (error) {
       const errorMsg = this.getErrorMessage(error);
       this.logger.error?.(`[Db] Error disconnecting: ${errorMsg}`);
@@ -3679,15 +3756,74 @@ var Db = class {
 function capitalizeFirstLetter(str) {
   return str.charAt(0).toUpperCase() + str.slice(1);
 }
+function resolveDbDisplayName(dbName, connectionParam, argsEnv, mergedName) {
+  if (dbName) {
+    return dbName;
+  }
+  if (mergedName) {
+    return mergedName;
+  }
+  if (connectionParam?.startsWith("dbConnectionString") && connectionParam.length > "dbConnectionString".length) {
+    return connectionParam.slice("dbConnectionString".length).toLowerCase();
+  }
+  if (connectionParam === "dbConnectionString" && argsEnv) {
+    return argsEnv;
+  }
+  return void 0;
+}
+function formatDbConnectMessage(name, connectionString) {
+  const endpointSuffix = formatConnectionEndpointSuffix(connectionString);
+  if (name) {
+    return `[Db] Connected to database "${name}"${endpointSuffix}`;
+  }
+  return `[Db] Connected${endpointSuffix}`;
+}
+function formatDbDisconnectMessage(name, connectionString) {
+  const endpointSuffix = formatConnectionEndpointSuffix(connectionString);
+  if (name) {
+    return `[Db] Disconnected from database "${name}"${endpointSuffix}`;
+  }
+  return `[Db] Disconnected${endpointSuffix}`;
+}
+function formatDbInstanceMessage(action, name) {
+  if (name) {
+    return `[Db] instance "${name}" ${action}`;
+  }
+  return `[Db] instance ${action}`;
+}
+function formatConnectionEndpointSuffix(connectionString) {
+  const endpoint = formatConnectionEndpoint(connectionString);
+  return endpoint ? ` (${endpoint})` : "";
+}
+function formatConnectionEndpoint(connectionString) {
+  try {
+    const url = new URL(connectionString);
+    const host = url.hostname;
+    if (!host) {
+      return null;
+    }
+    let port = url.port;
+    if (!port) {
+      if (url.protocol === "postgresql:") {
+        port = "5432";
+      } else if (url.protocol === "mysql:") {
+        port = "3306";
+      }
+    }
+    return port ? `${host}:${port}` : host;
+  } catch {
+    return null;
+  }
+}
 async function dbConnect(context, config2) {
   try {
     const db = new Db(config2);
     context.registerCleanup(async () => {
       await db.disconnect();
-      context.logger.debug?.(`[Db] instance "${config2.name}" disconnected`);
+      context.logger.debug?.(formatDbInstanceMessage("disconnected", config2.name));
     });
     await db.connect();
-    context.logger.debug?.(`[Db] instance "${config2.name}" initialized`);
+    context.logger.debug?.(formatDbInstanceMessage("initialized", config2.name));
     return db;
   } catch (error) {
     if (error instanceof ParamError) {
@@ -4286,7 +4422,16 @@ function setup(opts = {}) {
     emitter: partialContext.emitter,
     isStop: partialContext.isStop,
     cleanupFunctions: partialContext.cleanupFunctions,
-    registerCleanup: partialContext.registerCleanup
+    registerCleanup: partialContext.registerCleanup,
+    // For long-running scripts (servers): with --showUsedParams=top, print
+    // the used-params list now (after the script has initialized all its
+    // own components), instead of at exit. No-op for the default mode,
+    // which prints at exit via the cleanup registered by Params.
+    showUsedParamsIfNeeded: () => {
+      if (params.getShowUsedParamsMode?.() === "top") {
+        params.printUsedParams(logger);
+      }
+    }
   };
   logger.debug("[setup] completed successfully");
   return context;