dbsafedump

library1.0.4jsnpmunverified

DBSafeDump is a command-line interface (CLI) tool designed for securely dumping and anonymizing database data to ensure compliance with privacy regulations like GDPR. Currently at version 1.0.4, the package enables users to export databases with automatic sensitive data masking, migrate data between environments while anonymizing, and even scrub existing databases in-place. Its key differentiators include deterministic masking for consistent test data, support for multiple database types (MySQL, PostgreSQL, MSSQL, SQLite), and intelligent discovery of sensitive columns. It operates on a freemium model, with a free tier limited to 1,000 rows per table and paid tiers offering advanced features like unlimited rows, in-place scrubbing, and CI/CD integration. The tool is developed with a focus on automation and integration into CI/CD pipelines, requiring Node.js 18+ for execution. While the free tier works offline, paid licenses require periodic online verification through a device fingerprint.

database auth-security devops data

npm install dbsafedump

package ↗homepage ↗

INSTALL

IMPORT

SIG · DBSAFEDUMP

dbsafedump

databasejavascriptv1.0.4

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

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

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

dbsafedump dump

✓ dbsafedump dump -o backup.sql

✗ import { dump } from 'dbsafedump'

DBSafeDump is a CLI tool; its primary functionality is accessed via global installation or npx commands, not programmatic imports.

dbsafedump init

✓ dbsafedump init

✗ require('dbsafedump').init()

Configuration is managed through an interactive CLI wizard initiated by the 'init' command, not through library calls.

dbsafedump scrub

✓ dbsafedump scrub --ci

✗ DBSafeDump.scrubDatabase()

The 'scrub' command, for in-place anonymization, is also a CLI-exclusive function and is destructive. Use with caution.

This quick start demonstrates global installation, initial configuration, connection testing, and performing a basic database dump with anonymization.

npm install -g dbsafedump dbsafedump init # Follow interactive prompts to configure database connections dbsafedump test-connection # Verify database connection dbsafedump dump -o anonymized_data.sql # Dumps the configured database with anonymization to a SQL file

dbsafedump --version

Debug

Known issues

breakingThe `scrub` command performs in-place anonymization directly on your database. This is a destructive and irreversible operation that permanently alters data.

fix

Always ensure you have a full backup of your database before running the `scrub` command on any environment, especially production.

affects: >=1.0.0

gotchaThe FREE tier of DBSafeDump is limited to 1,000 rows per table. Operations exceeding this limit will fail until a paid license is activated.

fix

Upgrade to a STARTER or PRO license to remove the row limit. Check `dbsafedump.com/pricing` for details.

affects: >=1.0.0

gotchaDBSafeDump requires Node.js version 18 or newer to run. Using older versions will result in execution errors.

fix

Ensure your Node.js environment is updated to version 18 or higher. Use a version manager like `nvm` if managing multiple Node.js versions.

affects: >=1.0.0

gotchaPaid DBSafeDump licenses (STARTER/PRO) require periodic online verification. This process collects a hashed device fingerprint locally for license activation and verification, sending only the encrypted key to the server.

fix

Be aware of this privacy implication and ensure network connectivity for paid license verification. The FREE tier works offline without license checks.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Row limit exceeded. Please upgrade to a paid plan.

Attempting to dump or import more than 1,000 rows per table using the FREE tier.

fix

Purchase and activate a STARTER or PRO license, or filter your data to stay within the 1,000-row limit for free usage.

Error: Configuration file 'config.yml' not found. Run 'dbsafedump init'.

DBSafeDump commands were run without an initialized configuration file.

fix

Execute `dbsafedump init` to create the default `config.yml` and configure your database connections interactively.

Error: Node.js version x.y.z is not supported. Please use Node.js >=18.

The installed Node.js version on your system is older than the required minimum of 18.

fix

Update your Node.js installation to version 18 or newer. Consider using `nvm` (Node Version Manager) to manage different Node.js versions.

Error: Invalid license key provided. Please check your key and try again.

An incorrect or expired license key was entered during activation.

fix

Verify your license key for typos and ensure it is valid and active. If issues persist, contact DBSafeDump support.

Upgrade

Version history

1.0.4latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

21 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://www.npmjs.com/package/dbsafedump ↗

homepagehttps://dbsafedump.com ↗