tramp-migration

library0.1.2jsnpmunverified

A database migration tool with interactive design, version 0.1.2. It is framework- and language-agnostic, supporting any SQL database. Low release cadence (initial release). Differentiators: interactive mode, simple CLI, no framework binding, similar to db-migrate but simpler. Currently in early development.

database

npm install tramp-migration

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · TRAMP-MIGRATION

tramp-migration

databasejavascriptv0.1.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

tramp-migration

✓ import trampMigration from 'tramp-migration'

✗ const trampMigration = require('tramp-migration')

ESM module; requires Node >=14. Use default import.

CLI

✓ npx tramp-migration

✗ tramp-migration

CLI is invoked via npx; not a JavaScript import.

Migration

✓ import { Migration } from 'tramp-migration'

✗ import Migration from 'tramp-migration'

Named export for class; available in v0.1.0+.

Shows installation, migration file format, CLI usage, and programmatic API.

// Install globally or locally npm install tramp-migration // Create a migration file (e.g., migrations/001_create_users.js) export async function up(db) { await db.run(`CREATE TABLE users (id INT PRIMARY KEY, name TEXT)`); } export async function down(db) { await db.run(`DROP TABLE IF EXISTS users`); } // Use CLI to run migrations npx tramp-migration up npx tramp-migration down npx tramp-migration status // Programmatic usage import trampMigration from 'tramp-migration'; await trampMigration.run({ directory: './migrations' });

Debug

Known issues

gotchaMigration files must be ESM (.mjs) or CommonJS? The package expects ES modules.

fix

Use .mjs extension or set type:module in package.json.

affects: >=0.1.0

gotchaNo built-in database drivers; requires user to provide a database connection.

fix

Pass a db instance with run() method (e.g., better-sqlite3, pg).

affects: >=0.1.0

deprecatedVersion 0.1.x is unstable; API may change.

fix

Pin version or expect breaking changes.

affects: 0.1.x

Errors

Common errors & fixes

Error: Cannot find module 'tramp-migration'

Not installed or not in node_modules.

fix

Run npm install tramp-migration --save-dev or install globally.

TypeError: trampMigration.run is not a function

Incorrect import (default vs named) or older version.

fix

Use import trampMigration from 'tramp-migration' (default) and ensure version >=0.1.0.

Missing migration directory: ./migrations

Default directory not found; migration files required.

fix

Create a migrations folder with .js/.mjs files.

Upgrade

Version history

0.1.2latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

21 hits · last 30 days

node

OpenAI (training)

Resources

githubgit://github.com/mr5/tramp-migration ↗

packagetramp-migration ↗

homepagehttps://github.com/mr5/tramp-migration#readme ↗