Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslnode 18–226 runs
build_error
glibcnode 18–226 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
DBM CLI
✓ import { DBM } from 'tengits-dbm'
✗ const dbm = require('tengits-dbm'); const DBM = require('tengits-dbm').DBM;
ESM-only package; TypeScript types included. Import the DBM class for programmatic use. CJS require() will fail because package is type module.
ConnectionPoolManager
✓ import { ConnectionPoolManager } from 'tengits-dbm'
✗ const ConnectionPoolManager = require('tengits-dbm').ConnectionPoolManager;
ESM import for connection pool manager class; used for managing database connection pools. Not exported in CommonJS.
encryptPassword
✓ import { encryptPassword } from 'tengits-dbm'
✗ const encryptPassword = require('tengits-dbm').encryptPassword;
Utility function for encrypting passwords using AES-256-GCM. Only available via named ESM import.
decryptPassword
✓ import { decryptPassword } from 'tengits-dbm'
✗ const decryptPassword = require('tengits-dbm').decryptPassword;
Utility function for decrypting passwords. Must be used with the same master password as encryption.
Programmatic usage of DBM CLI: add connection, list, test, query databases, and remove connection with proper ESM imports.
// Set master password (required for encrypted storage)
process.env.DBM_MASTER_PASSWORD = 'your-secure-master-password';
import { DBM } from 'tengits-dbm';
const dbm = new DBM();
// Add a direct connection
await dbm.addConnection('mydb', {
host: '192.168.1.100',
port: 3306,
user: 'root',
password: 'mypassword'
});
// List all connections
const connections = await dbm.listConnections();
console.log(connections);
// Test connection
const testResult = await dbm.testConnection('mydb');
console.log(testResult ? 'Connection OK' : 'Connection failed');
// List databases
const databases = await dbm.listDatabases('mydb');
console.log(databases);
// Execute SQL
const result = await dbm.executeSQL('mydb', {
database: 'mydatabase',
sql: 'SELECT * FROM users LIMIT 10'
});
console.log(result);
// Remove connection
await dbm.removeConnection('mydb');
dbm --version
Errors
Common errors & fixes
ERR_REQUIRE_ESM: require() of ES Module /path/to/tengits-dbm/index.js not supported
Using CommonJS require() on an ESM-only package.
fixChange to ESM import: import { DBM } from 'tengits-dbm'; or set type: module in package.json. Error: Master password not set. Set DBM_MASTER_PASSWORD environment variable.
Missing environment variable DBM_MASTER_PASSWORD before calling encryption-related functions.
fixSet process.env.DBM_MASTER_PASSWORD = 'your-pass'; before using dbm.
TypeError: dbm.addConnection is not a function
Using wrong import or not initializing DBM instance properly.
fixUse import { DBM } from 'tengits-dbm'; then const dbm = new DBM(); and call dbm.addConnection(...). Audit
Dependencies
No dependency data recorded yet.